com.prowidesoftware.swift.utils

Class SwiftFormatUtils

java.lang.Object

com.prowidesoftware.swift.utils.SwiftFormatUtils

public class SwiftFormatUtils
extends java.lang.Object

This class provides methods to convert field components to objects. It handles for example; dates, currencies and general functions defined in the SWIFT standard.

• DATE1 MMDD
• DATE2 YYMMDD
• DATE3 YYMM
• DATE4 YYYYMMDD
• YEAR YYYY
• AMOUNT ###,### (digits with comma as decimal separator)
• TIME2 HHmmss
• TIME3 HH[mm]
• BOOL Y/N
• DATETIME YYYYMMDDHHMM
• DATETIME with short year YYMMDDHHMM
• DAYTIME DDHHMM
• MONTHDAY MMDD
• MIR
• MOR

Since:

6.0

Version:

$Id: SwiftFormatUtils.java,v 1.5 2014/05/02 20:13:42 sebastian Exp $

Author:

www.prowidesoftware.com

Constructor Summary

Constructors

Constructor and Description
SwiftFormatUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	getBIC(BIC bic) Gets the code from the parameter BIC.
static BIC	getBIC(java.lang.String code)
static java.lang.String	getBoolean(java.lang.Boolean bool) Parses a Boolean object into a string.
static java.lang.Boolean	getBoolean(java.lang.String string) Gets the given string as boolean.
static java.lang.String	getCurrency(java.util.Currency currency) Gets the currency code from the parameter Currency.
static java.util.Currency	getCurrency(java.lang.String code)
static java.lang.String	getDate1(java.util.Calendar date) Parses a Calendar object into a DATE1 string.
static java.util.Calendar	getDate1(java.lang.String strDate) Parses a DATE1 string (accept dates in format MMDD) into a Calendar object.
static java.lang.String	getDate2(java.util.Calendar date) Parses a Calendar object into a DATE2 string.
static java.util.Calendar	getDate2(java.lang.String strDate) Parses a DATE2 string (accept dates in format YYMMDD) into a Calendar object.
static java.lang.String	getDate3(java.util.Calendar date) Parses a Calendar object into a DATE1 string.
static java.util.Calendar	getDate3(java.lang.String strDate) Parses a DATE3 string (accept dates in format YYMM) into a Calendar object.
static java.lang.String	getDate4(java.util.Calendar date) Parses a Calendar object into a DATE1 string.
static java.util.Calendar	getDate4(java.lang.String strDate) Parses a DATE4 string (accept dates in format YYYYMMDD) into a Calendar object.
static java.lang.String	getDateTime(java.util.Calendar date) Parses a Calendar object into a string containing the DATETIME with YYYYMMDDHHMM format.
static java.util.Calendar	getDateTime(java.lang.String strDate) Parses a DATETIME string (accepts dates with time in YYYYMMDDHHMM format) into a Calendar object.
static java.lang.String	getDateTimeShortYear(java.util.Calendar date) Parses a Calendar object into a DATETIME with short year string in YYMMDDHHMM format.
static java.util.Calendar	getDateTimeShortYear(java.lang.String strDate) Parses a DATETIME with short year string (accepts dates with time in YYMMDDHHMM format) into a Calendar object.
static java.lang.String	getDayTime(java.util.Calendar date) Parses a Calendar object into a string containing the DAYTIME in DDHHMM format.
static java.util.Calendar	getDayTime(java.lang.String strDate) Parses a DAYTIME string (accepts dates with time in DDHHMM format) into a Calendar object.
static java.util.Calendar	getHhmm(java.lang.String hhmm)
static java.lang.String	getHour(java.util.Calendar date) Parses a Calendar object into a string containing the HOUR in HH format.
static java.util.Calendar	getHour(java.lang.String strDate) Parses an HOUR string (accepts time in HH format) into a Calendar object.
static java.lang.String	getMIR(MIR mir) Parses a MIR object into a string containing its serialized data.
static MIR	getMIR(java.lang.String value) Parses a string value into a MIR object.
static java.lang.String	getMonthDay(java.util.Calendar date) Parses a Calendar object into a string containing MONTHDAY in MMDD format.
static java.util.Calendar	getMonthDay(java.lang.String strDate) Parses a MONTHDAY string (accepts dates in MMDD format) into a Calendar object.
static java.lang.String	getMOR(MOR mor) Parses a MOR object into a string containing its serialized data.
static MOR	getMOR(java.lang.String value) Parses a string value into a MOR object.
static java.lang.String	getNumber(java.lang.Number number) Parses a Number into a SWIFT string number ####,## where trunked zero decimals and mandatory decimal separator.
static java.lang.Number	getNumber(java.lang.String amount) Parses a value into a java Number (BigDecimal) using the comma for decimal separator.
static java.lang.String	getOffset(java.util.Calendar date) Parses a Calendar object into a offset string.
static java.util.Calendar	getOffset(java.lang.String string)
static java.lang.Character	getSign(java.lang.String string)
static java.lang.String	getTime2(java.util.Calendar date) Parses a Calendar object into a TIME2 string.
static java.util.Calendar	getTime2(java.lang.String hhmmss)
static java.lang.String	getTime3(java.util.Calendar date) Parses a Calendar object into a TIME3 string.
static java.util.Calendar	getTime3(java.lang.String hhmmss)
static java.lang.String	getYear(java.util.Calendar date) Parses a Calendar object into a YYYY string.
static java.util.Calendar	getYear(java.lang.String strDate) Parses a YEAR string (accept dates in format YYYY) into a Calendar object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SwiftFormatUtils

public SwiftFormatUtils()

Method Detail

getBIC

public static java.lang.String getBIC(BIC bic)

Gets the code from the parameter BIC.

Parameters:

bic - BIC to use

Returns:

the string with the BIC code

Since:

6.4

getBIC

public static BIC getBIC(java.lang.String code)

Parameters:

code - string with a BIC code

Returns:

a BIC initialized from the parameter code

getBoolean

public static java.lang.String getBoolean(java.lang.Boolean bool)

Parses a Boolean object into a string.

Parameters:

bool - Boolean to parse

Returns:

parsed boolean converted to "Y" or "N" or null if the boolean object is null

Since:

7.4

getBoolean

public static java.lang.Boolean getBoolean(java.lang.String string)

Gets the given string as boolean.

Parameters:

string - code to use where the expected values are "Y" or "N"

Returns:

true for "Y", false for "N", and null otherwise

Since:

7.4

getCurrency

public static java.lang.String getCurrency(java.util.Currency currency)

Gets the currency code from the parameter Currency.

Parameters:

currency - Currency to use

Returns:

the string with the currency code

Since:

6.4

getCurrency

public static java.util.Currency getCurrency(java.lang.String code)

Parameters:

code - string with a currency code

Returns:

a Currency initialized from the parameter code

getDate1

public static java.lang.String getDate1(java.util.Calendar date)

Parses a Calendar object into a DATE1 string.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

6.4

getDate1

public static java.util.Calendar getDate1(java.lang.String strDate)

Parses a DATE1 string (accept dates in format MMDD) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

getDate2

public static java.lang.String getDate2(java.util.Calendar date)

Parses a Calendar object into a DATE2 string.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

getDate2

public static java.util.Calendar getDate2(java.lang.String strDate)

Parses a DATE2 string (accept dates in format YYMMDD) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

getDate3

public static java.lang.String getDate3(java.util.Calendar date)

Parses a Calendar object into a DATE1 string.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

6.4

getDate3

public static java.util.Calendar getDate3(java.lang.String strDate)

Parses a DATE3 string (accept dates in format YYMM) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

getDate4

public static java.lang.String getDate4(java.util.Calendar date)

Parses a Calendar object into a DATE1 string.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

6.4

getDate4

public static java.util.Calendar getDate4(java.lang.String strDate)

Parses a DATE4 string (accept dates in format YYYYMMDD) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

getDateTime

public static java.lang.String getDateTime(java.util.Calendar date)

Parses a Calendar object into a string containing the DATETIME with YYYYMMDDHHMM format.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

7.4

getDateTime

public static java.util.Calendar getDateTime(java.lang.String strDate)

Parses a DATETIME string (accepts dates with time in YYYYMMDDHHMM format) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

Since:

7.4

getDateTimeShortYear

public static java.lang.String getDateTimeShortYear(java.util.Calendar date)

Parses a Calendar object into a DATETIME with short year string in YYMMDDHHMM format.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

7.4

getDateTimeShortYear

public static java.util.Calendar getDateTimeShortYear(java.lang.String strDate)

Parses a DATETIME with short year string (accepts dates with time in YYMMDDHHMM format) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

Since:

7.4

getDayTime

public static java.lang.String getDayTime(java.util.Calendar date)

Parses a Calendar object into a string containing the DAYTIME in DDHHMM format.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

7.4

getDayTime

public static java.util.Calendar getDayTime(java.lang.String strDate)

Parses a DAYTIME string (accepts dates with time in DDHHMM format) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

Since:

7.4

getHhmm

public static java.util.Calendar getHhmm(java.lang.String hhmm)

Parameters:

hhmm - hour and minutes

Returns:

a Calendar set with the given hour and minutes

getHour

public static java.lang.String getHour(java.util.Calendar date)

Parses a Calendar object into a string containing the HOUR in HH format.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

7.4

getHour

public static java.util.Calendar getHour(java.lang.String strDate)

Parses an HOUR string (accepts time in HH format) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

Since:

7.4

getMIR

public static java.lang.String getMIR(MIR mir)

Parses a MIR object into a string containing its serialized data.

Parameters:

mir - MIR to process

Returns:

serialized content of the MIR object or null if the parameter is empty or null

Since:

7.4

See Also:

MIR.getMIR()

getMIR

public static MIR getMIR(java.lang.String value)

Parses a string value into a MIR object.

Parameters:

value - string containing the complete MIR value

Returns:

a MIR object containing the parsed data or null if the argument is not a 28 length string with a proper MIR data

See Also:

MIR

getMonthDay

public static java.lang.String getMonthDay(java.util.Calendar date)

Parses a Calendar object into a string containing MONTHDAY in MMDD format.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

7.4

getMonthDay

public static java.util.Calendar getMonthDay(java.lang.String strDate)

Parses a MONTHDAY string (accepts dates in MMDD format) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format

Since:

7.4

getMOR

public static java.lang.String getMOR(MOR mor)

Parses a MOR object into a string containing its serialized data.

Parameters:

mor - MOR to process

Returns:

serialized content of the MOR object or null if the parameter is empty or null

Since:

7.4

See Also:

MOR.getMOR()

getMOR

public static MOR getMOR(java.lang.String value)

Parses a string value into a MOR object.

Parameters:

value - string containing the complete MOR value

Returns:

a MOR object containing the parsed data or null if the argument is not a 28 length string with a proper MOR data

See Also:

MOR

getNumber

public static java.lang.String getNumber(java.lang.Number number)

Parses a Number into a SWIFT string number ####,## where trunked zero decimals and mandatory decimal separator.

• Example: 1234,
• Example: 1234,56

Parameters:

number - to parse

Returns:

Number of the parsed amount or null if the number is null

getNumber

public static java.lang.Number getNumber(java.lang.String amount)

Parses a value into a java Number (BigDecimal) using the comma for decimal separator.

Parameters:

amount - to parse

Returns:

Number of the parsed amount or null if the number could not be parsed

getOffset

public static java.lang.String getOffset(java.util.Calendar date)

Parses a Calendar object into a offset string.

Parameters:

date - Calendar to parse

Returns:

parsed time or null if the calendar is null

Since:

6.4

getOffset

public static java.util.Calendar getOffset(java.lang.String string)

Parameters:

string - with an offset

Returns:

a Calendar set with hour and minutes from the offset

getSign

public static java.lang.Character getSign(java.lang.String string)

Parameters:

string - with a single character

Returns:

the Character for the given string

getTime2

public static java.lang.String getTime2(java.util.Calendar date)

Parses a Calendar object into a TIME2 string.

Parameters:

date - Calendar to parse

Returns:

parsed time or null if the calendar is null

Since:

6.4

getTime2

public static java.util.Calendar getTime2(java.lang.String hhmmss)

Parameters:

hhmmss - hour, minutes and seconds

Returns:

a Calendar set with the given hour, minutes and seconds

getTime3

public static java.lang.String getTime3(java.util.Calendar date)

Parses a Calendar object into a TIME3 string.

Parameters:

date - Calendar to parse

Returns:

parsed time or null if the calendar is null

Since:

6.4

getTime3

public static java.util.Calendar getTime3(java.lang.String hhmmss)

Parameters:

hhmmss - hour, minutes and seconds

Returns:

a Calendar set with the given hour, or and hour and minutes

getYear

public static java.lang.String getYear(java.util.Calendar date)

Parses a Calendar object into a YYYY string.

Parameters:

date - Calendar to parse

Returns:

parsed date or null if the calendar is null

Since:

6.4

getYear

public static java.util.Calendar getYear(java.lang.String strDate)

Parses a YEAR string (accept dates in format YYYY) into a Calendar object.

Parameters:

strDate - string to parse

Returns:

parsed date or null if the argument did not matched the expected date format