Package com.ethlo.time
Class ITU
java.lang.Object
com.ethlo.time.ITU
The main access to the parse and formatting functions in this library.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic String
format
(OffsetDateTime offsetDateTime) Format the input as an RFC-3339 formatted date-time in the timezone of the input.static String
format
(OffsetDateTime offsetDateTime, int fractionDigits) Format the input as an RFC-3339 formatted date-time in the timezone of the input, with the specified number of fraction digits.static String
formatUtc
(OffsetDateTime offsetDateTime) Format the input as an RFC-3339 formatted date-time in the UTC timezone with second resolution.static String
formatUtc
(OffsetDateTime offsetDateTime, int fractionDigits) Format the input as an RFC-3339 formatted date-time in the UTC timezonestatic String
formatUtc
(OffsetDateTime offsetDateTime, Field lastIncluded) Format the input as an ISO format string, limited to the granularity of the specified field, in the UTC timezone.static String
formatUtcMicro
(OffsetDateTime offsetDateTime) Format the input as an RFC-3339 formatted date-time in the UTC timezone with microsecond resolution.static String
formatUtcMilli
(OffsetDateTime offsetDateTime) Format the input as an RFC-3339 formatted date-time in the UTC timezone with millisecond resolution.static String
formatUtcNano
(OffsetDateTime offsetDateTime) Format the input as an RFC-3339 formatted date-time in the UTC timezone with nanosecond resolutionprivate static boolean
isAllowed
(TemporalType needle, TemporalType... allowed) static boolean
Check if the dateTime is valid according to the RFC-3339 specificationstatic boolean
isValid
(String text, TemporalType... types) Check if the input is valid for one of the specified typesstatic void
parse
(String text, TemporalConsumer temporalConsumer) Parse the input, and use callbacks for the type of date/date-time it contains.static <T> T
parse
(String text, TemporalHandler<T> temporalHandler) Parse the input, and use callbacks for the type of date/date-time it contains.static OffsetDateTime
parseDateTime
(String text) Parse an RFC-3339 formatted date-time to anOffsetDateTime
static OffsetDateTime
parseDateTime
(String text, ParsePosition position) static DateTime
parseLenient
(String text) Parse an ISO formatted date and optionally time to aDateTime
.static DateTime
parseLenient
(String text, ParseConfig parseConfig) Allows parsing leniently withto control some aspects of the parsing
static DateTime
parseLenient
(String text, ParseConfig parseConfig, ParsePosition position)
-
Constructor Details
-
ITU
private ITU()
-
-
Method Details
-
parseDateTime
Parse an RFC-3339 formatted date-time to anOffsetDateTime
- Parameters:
text
- The text to parse- Returns:
- The date and time parsed
-
parseDateTime
-
parseLenient
Parse an ISO formatted date and optionally time to aDateTime
. The result has rudimentary checks for correctness, but will not be aware of number of days per specific month or leap-years.- Parameters:
text
- The text to parse- Returns:
- The date and time parsed
-
parseLenient
Allows parsing leniently withto control some aspects of the parsing
- Parameters:
text
- The text to parseparseConfig
- The configuration to use for parsing- Returns:
- The date-time parsed
-
parseLenient
- Parameters:
text
- The text to parseparseConfig
- The configuration to use for parsingposition
- The position to start parsing from. The index (and the errorIndex, if an error occurs) is updated after the parsing process has completed- Returns:
- The date-time parsed
-
isValid
Check if the dateTime is valid according to the RFC-3339 specification- Parameters:
text
- The input to validate- Returns:
- True if valid, otherwise false
-
formatUtc
Format the input as an RFC-3339 formatted date-time in the UTC timezone- Parameters:
offsetDateTime
- The date-time to formatfractionDigits
- The number of fraction digits in the second field- Returns:
- The formatted string
-
formatUtc
Format the input as an ISO format string, limited to the granularity of the specified field, in the UTC timezone.- Parameters:
offsetDateTime
- The date-time to formatlastIncluded
- The last included field- Returns:
- The formatted string
-
format
Format the input as an RFC-3339 formatted date-time in the timezone of the input.- Parameters:
offsetDateTime
- The date-time to format- Returns:
- The formatted string
-
format
Format the input as an RFC-3339 formatted date-time in the timezone of the input, with the specified number of fraction digits.- Parameters:
offsetDateTime
- The date-time to formatfractionDigits
- The number of fraction digits in the second field- Returns:
- The formatted string
-
formatUtc
Format the input as an RFC-3339 formatted date-time in the UTC timezone with second resolution.- Parameters:
offsetDateTime
- The date-time to format.- Returns:
- The formatted string with second resolution.
-
formatUtcMilli
Format the input as an RFC-3339 formatted date-time in the UTC timezone with millisecond resolution.- Parameters:
offsetDateTime
- The date-time to format.- Returns:
- The formatted string with millisecond resolution.
-
formatUtcMicro
Format the input as an RFC-3339 formatted date-time in the UTC timezone with microsecond resolution.- Parameters:
offsetDateTime
- The date-time to format- Returns:
- The formatted string with microsecond resolution
-
formatUtcNano
Format the input as an RFC-3339 formatted date-time in the UTC timezone with nanosecond resolution- Parameters:
offsetDateTime
- The date-time to format- Returns:
- The formatted string with nanosecond resolution
-
parse
Parse the input, and use callbacks for the type of date/date-time it contains. This allows you to handle different granularity inputs with ease!- Parameters:
text
- The text to parse as a date/date-timetemporalConsumer
- The consumer of the found date/date-time
-
parse
Parse the input, and use callbacks for the type of date/date-time it contains. This allows you to handle different granularity inputs with ease!- Type Parameters:
T
- The type of Temporal returned- Parameters:
text
- The text to parse as a date/date-timetemporalHandler
- The handler of the found date/date-time- Returns:
- The temporal matching the type handled
-
isValid
Check if the input is valid for one of the specified types- Parameters:
text
- The input to checktypes
- The types that are considered valid- Returns:
- True if valid, otherwise false
-
isAllowed
-