org.apache.paimon.utils

Class TimeUtils

java.lang.Object

org.apache.paimon.utils.TimeUtils

public class TimeUtils
extends Object

Collection of utilities about time intervals.

Constructor Summary

Constructors

Constructor and Description
TimeUtils()

Method Summary

Modifier and Type	Method and Description
static String	formatWithHighestUnit(java.time.Duration duration) Pretty prints the duration as a lowest granularity unit that does not lose precision.
static String	getStringInMillis(java.time.Duration duration)
static java.time.Duration	parseDuration(long number, String unitLabel) Parse the given number and unitLabel to a java Duration.
static java.time.Duration	parseDuration(String text) Parse the given string to a java Duration.

Methods inherited from class java.lang.Object

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

Constructor Detail

TimeUtils

public TimeUtils()

Method Detail

parseDuration

public static java.time.Duration parseDuration(String text)

Parse the given string to a java Duration. The string is in format "{length value}{time unit label}", e.g. "123ms", "321 s". If no time unit label is specified, it will be considered as milliseconds.

Supported time unit labels are:

• DAYS： "d", "day"
• HOURS： "h", "hour"
• MINUTES： "m", "min", "minute"
• SECONDS： "s", "sec", "second"
• MILLISECONDS： "ms", "milli", "millisecond"
• MICROSECONDS： "µs", "micro", "microsecond"
• NANOSECONDS： "ns", "nano", "nanosecond"

Parameters:

text - string to parse.

parseDuration

public static java.time.Duration parseDuration(long number,
                                               String unitLabel)

Parse the given number and unitLabel to a java Duration. The usage is in format "(digital number, time unit label)", e.g. "(1, DAYS)".

Parameters:

number - a digital number

unitLabel - time unit label

getStringInMillis

public static String getStringInMillis(java.time.Duration duration)

Parameters:

duration - to convert to string

Returns:

duration string in millis

formatWithHighestUnit

public static String formatWithHighestUnit(java.time.Duration duration)

Pretty prints the duration as a lowest granularity unit that does not lose precision.

Examples:

 Duration.ofMilliseconds(60000) will be printed as 1 min
 Duration.ofHours(1).plusSeconds(1) will be printed as 3601 s
 

NOTE: It supports only durations that fit into long.