pro.fessional.mirana.time

Class ThreadNow

java.lang.Object

pro.fessional.mirana.time.ThreadNow

public class ThreadNow
extends Object

 Provides thread-level customization of the clock.
 The default implementation uses ThreadLocal and does not support inheritable.
 The default ThreadLocal can be replaced by subclassing `init`, e.g. using TransmittableThreadLocal.

 Note that
 (1) To avoid ThreadLocal leakage, it is recommended to use try-finally mode.
 (2) subclass replacement must before any use, such as Spring's container configuration before the business.

 Benchmark               Mode  Cnt      Score      Error   Units
 Now.localDateTime(CN)   thrpt  6   11554.389 ±  1750.603  ops/ms
 LocalDateTime.now(CN)   thrpt  6   13434.876 ±   686.115  ops/ms
 ThreadNow.sysZone()     thrpt  6   19666.947 ±  4895.100  ops/ms
 ZoneId.systemDefault()  thrpt  6  263911.747 ± 13128.798  ops/ms
 

Since:

2022-10-10

Author:

trydofor

Field Summary

Fields

Modifier and Type	Field and Description
static TweakingContext<Clock>	TweakClock
static TweakingContext<TimeZone>	TweakZone
static TimeZone	UtcTimeZone
static ZoneId	UtcZoneId

Constructor Summary

Constructors

Constructor and Description
ThreadNow()

Method Summary

Modifier and Type	Method and Description
static @NotNull Clock	clock() get current clock
static @NotNull Clock	clock(ZoneId zid)
static @NotNull Instant	instant()
static @NotNull Instant	instant(ZoneId zid)
static @NotNull LocalDate	localDate()
static @NotNull LocalDate	localDate(ZoneId zid)
static @NotNull LocalDateTime	localDateTime()
static @NotNull LocalDateTime	localDateTime(ZoneId zid)
static @NotNull LocalTime	localTime()
static @NotNull LocalTime	localTime(ZoneId zid)
static long	millis() get current millis
static @NotNull OffsetDateTime	offsetDateTime()
static @NotNull OffsetDateTime	offsetDateTime(ZoneId zid)
static TimeZone	sysTimeZone() get system timezone
static ZoneId	sysZoneId() get system zoneid, Java11 is optimized
static TimeZone	utcTimeZone() get UTC timezone
static ZoneId	utcZoneId() get UTC zoneid
static @NotNull Date	utilDate()
static @NotNull Date	utilDate(ZoneId zid)
static @NotNull ZonedDateTime	zonedDateTime()
static @NotNull ZonedDateTime	zonedDateTime(ZoneId zid)

Methods inherited from class java.lang.Object

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

Field Detail

UtcTimeZone

public static final TimeZone UtcTimeZone

UtcZoneId

public static final ZoneId UtcZoneId

TweakZone

public static final TweakingContext<TimeZone> TweakZone

TweakClock

public static final TweakingContext<Clock> TweakClock

Constructor Detail

ThreadNow

public ThreadNow()

Method Detail

sysTimeZone

public static TimeZone sysTimeZone()

get system timezone

sysZoneId

public static ZoneId sysZoneId()

get system zoneid, Java11 is optimized

utcTimeZone

public static TimeZone utcTimeZone()

get UTC timezone

See Also:

UtcTimeZone

utcZoneId

public static ZoneId utcZoneId()

get UTC zoneid

See Also:

UtcZoneId

clock

@NotNull
public static @NotNull Clock clock()

get current clock

millis

public static long millis()

get current millis

instant

@NotNull
public static @NotNull Instant instant()

localDate

@NotNull
public static @NotNull LocalDate localDate()

localTime

@NotNull
public static @NotNull LocalTime localTime()

localDateTime

@NotNull
public static @NotNull LocalDateTime localDateTime()

zonedDateTime

@NotNull
public static @NotNull ZonedDateTime zonedDateTime()

offsetDateTime

@NotNull
public static @NotNull OffsetDateTime offsetDateTime()

utilDate

@NotNull
public static @NotNull Date utilDate()

clock

@NotNull
public static @NotNull Clock clock(ZoneId zid)

instant

@NotNull
public static @NotNull Instant instant(ZoneId zid)

localDate

@NotNull
public static @NotNull LocalDate localDate(ZoneId zid)

localTime

@NotNull
public static @NotNull LocalTime localTime(ZoneId zid)

localDateTime

@NotNull
public static @NotNull LocalDateTime localDateTime(ZoneId zid)

zonedDateTime

@NotNull
public static @NotNull ZonedDateTime zonedDateTime(ZoneId zid)

offsetDateTime

@NotNull
public static @NotNull OffsetDateTime offsetDateTime(ZoneId zid)

utilDate

@NotNull
public static @NotNull Date utilDate(ZoneId zid)