DateTimeUtils (CODA Converters 1.7.6 API)

java.lang.Object
- it.uniroma2.art.coda.converters.commons.DateTimeUtils

```
public class DateTimeUtils
extends Object
```
Utility class related to the management of date/time values.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`DATE_PATTERN_ISO_8601`
`private static List<String>`	`datePatternsDigit`
`private static List<String>`	`datePatternsText`
`static String`	`DATETIME_PATTERN_ISO_8601`
`private static List<String>`	`datetimePatterns`
`static String`	`OFFSET_PARAM_PATTERN`
`static String`	`OFFSET_PARAM_REUSE`
`static String`	`OFFSET_PARAM_UNDEFINED`
`static String`	`OFFSET_PARAM_Z`
`static String`	`TIME_PATTERN_ISO_8601`
`private static List<String>`	`timeOffsetPatterns`
`private static List<String>`	`timePatterns`

Constructor Summary

Constructors
Constructor and Description

DateTimeUtils()

Constructors
Constructor and Description
`DateTimeUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`applyOffsetToDatetime(String inputDatetime, String formattedDatetime, String offset)` Applies an offset to a datetime
`static String`	`applyOffsetToTime(String inputTime, String formattedTime, String offset)` Applies an offset to a time
`static ZoneOffset`	`getOffsetFromDatetime(String datetime)` Tries to detect offset from datetime.
`static ZoneOffset`	`getOffsetFromTime(String time)` Tries to detect offset from time.
`static DateTimeFormatter`	`inferDateFormat(String value)` Tries to infer the date pattern for the given value, then returns a DateTimeFormatter with the inferred pattern.
`static DateTimeFormatter`	`inferDatetimeFormat(String value, boolean onlyWithOffset)` Tries to infer the datetime pattern for the given value, then returns a DateTimeFormatter with the inferred pattern.
`static DateTimeFormatter`	`inferFormatForDate(String value)` Tries to infer the pattern of the input value in order to generate a date, so tries to parse it using date and datetime patterns (no time patterns since an input time value cannot be converted to a date)
`static DateTimeFormatter`	`inferFormatForDatetime(String value, boolean onlyWithOffset)` Tries to infer the pattern of the input value in order to generate a datetime, so tries to parse it using date, time and datetime patterns
`static DateTimeFormatter`	`inferFormatForTime(String value, boolean onlyWithOffset)` Tries to infer the pattern of the input value in order to generate a time, so tries to parse it using time and datetime patterns (no date patterns since an input date value cannot be converted to a time)
`static DateTimeFormatter`	`inferTimeFormat(String value, boolean onlyWithOffset)` Tries to infer the time pattern for the given value, then returns a DateTimeFormatter with the inferred pattern.
`static ZoneOffset`	`parseOffset(String offset)`
`static ZoneOffset`	`sumOffsets(ZoneOffset offset1, ZoneOffset offset2)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DATE_PATTERN_ISO_8601
```
public static final String DATE_PATTERN_ISO_8601
```
    See Also:
    
    Constant Field Values
  - TIME_PATTERN_ISO_8601
```
public static final String TIME_PATTERN_ISO_8601
```
    See Also:
    
    Constant Field Values
  - DATETIME_PATTERN_ISO_8601
```
public static final String DATETIME_PATTERN_ISO_8601
```
    See Also:
    
    Constant Field Values
  - OFFSET_PARAM_UNDEFINED
```
public static final String OFFSET_PARAM_UNDEFINED
```
    See Also:
    
    Constant Field Values
  - OFFSET_PARAM_Z
```
public static final String OFFSET_PARAM_Z
```
    See Also:
    
    Constant Field Values
  - OFFSET_PARAM_REUSE
```
public static final String OFFSET_PARAM_REUSE
```
    See Also:
    
    Constant Field Values
  - OFFSET_PARAM_PATTERN
```
public static final String OFFSET_PARAM_PATTERN
```
    See Also:
    
    Constant Field Values
  - datePatternsDigit
```
private static final List<String> datePatternsDigit
```
  - datePatternsText
```
private static final List<String> datePatternsText
```
  - timePatterns
```
private static final List<String> timePatterns
```
  - datetimePatterns
```
private static final List<String> datetimePatterns
```
  - timeOffsetPatterns
```
private static final List<String> timeOffsetPatterns
```
- Constructor Detail
  - DateTimeUtils
```
public DateTimeUtils()
```
- Method Detail
  - inferFormatForDate
```
public static DateTimeFormatter inferFormatForDate(String value)
```
    Tries to infer the pattern of the input value in order to generate a date, so tries to parse it using date and datetime patterns (no time patterns since an input time value cannot be converted to a date)
    
    Parameters:
    
    value -
    
    Returns:
  - inferFormatForTime
```
public static DateTimeFormatter inferFormatForTime(String value,
                                                   boolean onlyWithOffset)
```
    Tries to infer the pattern of the input value in order to generate a time, so tries to parse it using time and datetime patterns (no date patterns since an input date value cannot be converted to a time)
    
    Parameters:
    
    value -
    
    onlyWithOffset - tells if this method should look only for pattern with timezone offset
    
    Returns:
  - inferFormatForDatetime
```
public static DateTimeFormatter inferFormatForDatetime(String value,
                                                       boolean onlyWithOffset)
```
    Tries to infer the pattern of the input value in order to generate a datetime, so tries to parse it using date, time and datetime patterns
    
    Parameters:
    
    value -
    
    onlyWithOffset - tells if this method should look only for pattern with timezone offset
    
    Returns:
  - inferDateFormat
```
public static DateTimeFormatter inferDateFormat(String value)
```
    Tries to infer the date pattern for the given value, then returns a DateTimeFormatter with the inferred pattern. This method takes for granted that the input value is a date, so tries to parse it with only the available date patterns. Returns null if no pattern can parse the input.
    
    Parameters:
    
    value -
    
    Returns:
  - inferTimeFormat
```
public static DateTimeFormatter inferTimeFormat(String value,
                                                boolean onlyWithOffset)
```
    Tries to infer the time pattern for the given value, then returns a DateTimeFormatter with the inferred pattern. This method takes for granted that the input value is a time, so tries to parse it with only the available date patterns. Returns null if no pattern can parse the input.
    
    Parameters:
    
    value -
    
    onlyWithOffset - tells if this method should look only for pattern with timezone offset
    
    Returns:
  - inferDatetimeFormat
```
public static DateTimeFormatter inferDatetimeFormat(String value,
                                                    boolean onlyWithOffset)
```
    Tries to infer the datetime pattern for the given value, then returns a DateTimeFormatter with the inferred pattern. This method takes for granted that the input value is a datetime, so tries to parse it with only the available datetime patterns. Returns null if no pattern can parse the input.
    
    Parameters:
    
    value -
    
    onlyWithOffset - tells if this method should look only for pattern with timezone offset
    
    Returns:
  - applyOffsetToTime
```
public static String applyOffsetToTime(String inputTime,
                                       String formattedTime,
                                       String offset)
                                throws ConverterConfigurationException
```
    Applies an offset to a time
    
    Parameters:
    
    inputTime - input value used to get the offset in case of offset param is "reuse"
    
    formattedTime - time (already formatted according to ISO TIME) to which apply the offset
    
    offset - admitted values:
    undefined: the output time does not contain any offset, if the input value has offset it is lost
    
    Z: Zulu timezone
    
    <hh>:<mm>: the given offset, specified in hours and minutes, is applied to the input value, or added if the latter already contains an offset
    
    reuse: is applied the same offset of the input
    
    Returns:
    
    Throws:
    
    ConverterConfigurationException
  - applyOffsetToDatetime
```
public static String applyOffsetToDatetime(String inputDatetime,
                                           String formattedDatetime,
                                           String offset)
                                    throws ConverterConfigurationException
```
    Applies an offset to a datetime
    
    Parameters:
    
    inputDatetime - input value used to get the offset in case of offset param is "reuse"
    
    formattedDatetime - datetime (already formatted according to ISO DATETIME) to which apply the offset
    
    offset - admitted values:
    undefined: the output time does not contain any offset, if the input value has offset it is lost
    
    Z: Zulu timezone
    
    <hh>:<mm>: the given offset, specified in hours and minutes, is applied to the input value, or added if the latter already contains an offset
    
    reuse: is applied the same offset of the input
    
    Returns:
    
    Throws:
    
    ConverterConfigurationException
  - getOffsetFromTime
```
public static ZoneOffset getOffsetFromTime(String time)
```
    Tries to detect offset from time. Returns offset if it's found in the input time, null otherwise.
    
    Parameters:
    
    time -
    
    Returns:
  - getOffsetFromDatetime
```
public static ZoneOffset getOffsetFromDatetime(String datetime)
```
    Tries to detect offset from datetime. Returns offset if it's found in the input datetime, null otherwise.
    
    Parameters:
    
    time -
    
    Returns:
  - parseOffset
```
public static ZoneOffset parseOffset(String offset)
```
  - sumOffsets
```
public static ZoneOffset sumOffsets(ZoneOffset offset1,
                                    ZoneOffset offset2)
```

Class DateTimeUtils

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DATE_PATTERN_ISO_8601

TIME_PATTERN_ISO_8601

DATETIME_PATTERN_ISO_8601

OFFSET_PARAM_UNDEFINED

OFFSET_PARAM_Z

OFFSET_PARAM_REUSE

OFFSET_PARAM_PATTERN

datePatternsDigit

datePatternsText

timePatterns

datetimePatterns

timeOffsetPatterns

Constructor Detail

DateTimeUtils

Method Detail

inferFormatForDate

inferFormatForTime

inferFormatForDatetime

inferDateFormat

inferTimeFormat

inferDatetimeFormat

applyOffsetToTime

applyOffsetToDatetime

getOffsetFromTime

getOffsetFromDatetime

parseOffset

sumOffsets