Packages

  • package root
    Definition Classes
    root
  • package java
    Definition Classes
    root
  • package time

    The main API for dates, times, instants, and durations.

    The main API for dates, times, instants, and durations.

    The classes defined here represent the principal date-time concepts, including instants, durations, dates, times, time-zones and periods. They are based on the ISO calendar system, which is the de facto world calendar following the proleptic Gregorian rules. All the classes are immutable and thread-safe.

    Each date time instance is composed of fields that are conveniently made available by the APIs. For lower level access to the fields refer to the org.threeten.bp.temporal package. Each class includes support for printing and parsing all manner of dates and times. Refer to the org.threeten.bp.format package for customization options.

    The org.threeten.bp.chrono package contains the calendar neutral API. This is intended for use by applications that need to use localized calendars. It is recommended that applications use the ISO-8601 dates and time classes from this package across system boundaries, such as to the database or across the network. The calendar neutral API should be reserved for interactions with users.

    Dates and Times

    org.threeten.bp.Instant is essentially a numeric timestamp. The current Instant can be retrieved from a org.threeten.bp.Clock. This is useful for logging and persistence of a point in time and has in the past been associated with storing the result from java.lang.System#currentTimeMillis().

    org.threeten.bp.LocalDate stores a date without a time. This stores a date like '2010-12-03' and could be used to store a birthday.

    org.threeten.bp.LocalTime stores a time without a date. This stores a time like '11:30' and could be used to store an opening or closing time.

    org.threeten.bp.LocalDateTime stores a date and time. This stores a date-time like '2010-12-03T11:30'.

    org.threeten.bp.OffsetTime stores a time and offset from UTC without a date. This stores a date like '11:30+01:00'. The ZoneOffset is of the form '+01:00'.

    org.threeten.bp.OffsetDateTime stores a date and time and offset from UTC. This stores a date-time like '2010-12-03T11:30+01:00'. This is sometimes found in XML messages and other forms of persistence, but contains less information than a full time-zone.

    org.threeten.bp.ZonedDateTime stores a date and time with a time-zone. This is useful if you want to perform accurate calculations of dates and times taking into account the org.threeten.bp.ZoneId, such as 'Europe/Paris'. Where possible, it is recommended to use a simpler class. The widespread use of time-zones tends to add considerable complexity to an application.

    Duration and Period

    Beyond dates and times, the API also allows the storage of period and durations of time. A org.threeten.bp.Duration is a simple measure of time along the time-line in nanoseconds. A org.threeten.bp.Period expresses an amount of time in units meaningful to humans, such as years or hours.

    Additional value types

    org.threeten.bp.Year stores a year on its own. This stores a single year in isolation, such as '2010'.

    org.threeten.bp.YearMonth stores a year and month without a day or time. This stores a year and month, such as '2010-12' and could be used for a credit card expiry.

    org.threeten.bp.MonthDay stores a month and day without a year or time. This stores a month and day-of-month, such as '--12-03' and could be used to store an annual event like a birthday without storing the year.

    org.threeten.bp.Month stores a month on its own. This stores a single month-of-year in isolation, such as 'DECEMBER'.

    org.threeten.bp.DayOfWeek stores a day-of-week on its own. This stores a single day-of-week in isolation, such as 'TUESDAY'.

    Definition Classes
    java
  • package zone

    Support for time-zones and their rules.

    Support for time-zones and their rules.

    Daylight Saving Time and Time-Zones are concepts used by Governments to alter local time. This package provides support for time-zones, their rules and the resulting gaps and overlaps in the local time-line typically caused by Daylight Saving Time.

    Definition Classes
    time
  • DefaultTzdbZoneRulesProvider
  • Ser
  • ServiceLoaderZoneRulesInitializer
  • StandardZoneRules
  • ZoneMap
  • ZoneOffsetTransition
  • ZoneOffsetTransitionRule
  • ZoneRules
  • ZoneRulesBuilder
  • ZoneRulesException
  • ZoneRulesInitializer
  • ZoneRulesProvider
c

java.time.zone

ZoneRulesBuilder

class ZoneRulesBuilder extends AnyRef

A mutable builder used to create all the rules for a historic time-zone.

The rules of a time-zone describe how the offset changes over time. The rules are created by building windows on the time-line within which the different rules apply. The rules may be one of two kinds:

  • Fixed savings - A single fixed amount of savings from the standard offset will apply.
  • Rules - A set of one or more rules describe how daylight savings changes during the window.
Specification for implementors

This class is a mutable builder used to create zone instances. It must only be used from a single thread. The created instances are immutable and thread-safe.

Constructs an instance of the builder that can be used to create zone rules.

The builder is used by adding one or more windows representing portions of the time-line. The standard offset from UTC/Greenwich will be constant within a window, although two adjacent windows can have the same standard offset.

Within each window, there can either be a fixed savings amount or a list of rules.

Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. ZoneRulesBuilder
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new ZoneRulesBuilder()

Type Members

  1. class TZRule extends AnyRef

    A definition of the way a local time can be converted to an offset time.

    A definition of the way a local time can be converted to an offset time.

    Attributes
    protected[zone]
  2. class TZRuleComparator extends Comparator[TZRule]

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. def addRuleToWindow(startYear: Int, endYear: Int, month: Month, dayOfMonthIndicator: Int, dayOfWeek: DayOfWeek, time: LocalTime, timeEndOfDay: Boolean, timeDefinition: TimeDefinition, savingAmountSecs: Int): ZoneRulesBuilder

    Adds a multi-year transition rule to the current window.

    Adds a multi-year transition rule to the current window.

    This adds a rule such that the offset, expressed as a daylight savings amount, changes at the specified date-time for each year in the range.

    startYear

    the start year of the rule, from MIN_VALUE to MAX_VALUE

    endYear

    the end year of the rule, from MIN_VALUE to MAX_VALUE

    month

    the month of the transition, not null

    dayOfMonthIndicator

    the day-of-month of the transition, adjusted by dayOfWeek, from 1 to 31 adjusted later, or -1 to -28 adjusted earlier from the last day of the month

    dayOfWeek

    the day-of-week to adjust to, null if day-of-month should not be adjusted

    time

    the time that the transition occurs as defined by timeDefintion, not null

    timeEndOfDay

    whether midnight is at the end of day

    timeDefinition

    the definition of how to convert local to actual time, not null

    savingAmountSecs

    the amount of saving from the standard offset after the transition in seconds

    returns

    this, for chaining

    Exceptions thrown

    DateTimeException if a date-time field is out of range

    IllegalArgumentException if the end of day midnight flag does not match the time

    IllegalStateException if the window has reached the maximum capacity of 2000 rules

  5. def addRuleToWindow(year: Int, month: Month, dayOfMonthIndicator: Int, time: LocalTime, timeEndOfDay: Boolean, timeDefinition: TimeDefinition, savingAmountSecs: Int): ZoneRulesBuilder

    Adds a single transition rule to the current window.

    Adds a single transition rule to the current window.

    This adds a rule such that the offset, expressed as a daylight savings amount, changes at the specified date-time.

    year

    the year of the transition, from MIN_VALUE to MAX_VALUE

    month

    the month of the transition, not null

    dayOfMonthIndicator

    the day-of-month of the transition, adjusted by dayOfWeek, from 1 to 31 adjusted later, or -1 to -28 adjusted earlier from the last day of the month

    time

    the time that the transition occurs as defined by timeDefintion, not null

    timeEndOfDay

    whether midnight is at the end of day

    timeDefinition

    the definition of how to convert local to actual time, not null

    savingAmountSecs

    the amount of saving from the standard offset after the transition in seconds

    returns

    this, for chaining

    Exceptions thrown

    DateTimeException if a date-time field is out of range

    IllegalStateException if the window has reached the maximum capacity of 2000 rules

  6. def addRuleToWindow(transitionDateTime: LocalDateTime, timeDefinition: TimeDefinition, savingAmountSecs: Int): ZoneRulesBuilder

    Adds a single transition rule to the current window.

    Adds a single transition rule to the current window.

    This adds a rule such that the offset, expressed as a daylight savings amount, changes at the specified date-time.

    transitionDateTime

    the date-time that the transition occurs as defined by timeDefintion, not null

    timeDefinition

    the definition of how to convert local to actual time, not null

    savingAmountSecs

    the amount of saving from the standard offset after the transition in seconds

    returns

    this, for chaining

    Exceptions thrown

    IllegalStateException if the window has reached the maximum capacity of 2000 rules

  7. def addWindow(standardOffset: ZoneOffset, until: LocalDateTime, untilDefinition: TimeDefinition): ZoneRulesBuilder

    Adds a window to the builder that can be used to filter a set of rules.

    Adds a window to the builder that can be used to filter a set of rules.

    This method defines and adds a window to the zone where the standard offset is specified. The window limits the effect of subsequent additions of transition rules or fixed savings. If neither rules or fixed savings are added to the window then the window will default to no savings.

    Each window must be added sequentially, as the start instant of the window is derived from the until instant of the previous window.

    standardOffset

    the standard offset, not null

    until

    the date-time that the offset applies until, not null

    untilDefinition

    the time type for the until date-time, not null

    returns

    this, for chaining

    Exceptions thrown

    IllegalStateException if the window order is invalid

  8. def addWindowForever(standardOffset: ZoneOffset): ZoneRulesBuilder

    Adds a window that applies until the end of time to the builder that can be used to filter a set of rules.

    Adds a window that applies until the end of time to the builder that can be used to filter a set of rules.

    This method defines and adds a window to the zone where the standard offset is specified. The window limits the effect of subsequent additions of transition rules or fixed savings. If neither rules or fixed savings are added to the window then the window will default to no savings.

    This must be added after all other windows. No more windows can be added after this one.

    standardOffset

    the standard offset, not null

    returns

    this, for chaining

    Exceptions thrown

    IllegalStateException if a forever window has already been added

  9. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  10. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()
  11. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  12. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  13. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  14. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  15. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  16. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  17. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  18. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  19. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  20. def setFixedSavingsToWindow(fixedSavingAmountSecs: Int): ZoneRulesBuilder

    Sets the previously added window to have fixed savings.

    Sets the previously added window to have fixed savings.

    Setting a window to have fixed savings simply means that a single daylight savings amount applies throughout the window. The window could be small, such as a single summer, or large, such as a multi-year daylight savings.

    A window can either have fixed savings or rules but not both.

    fixedSavingAmountSecs

    the amount of saving to use for the whole window, not null

    returns

    this, for chaining

    Exceptions thrown

    IllegalStateException if the window already has rules

  21. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  22. def toRules(zoneId: String): ZoneRules

    Completes the build converting the builder to a set of time-zone rules.

    Completes the build converting the builder to a set of time-zone rules.

    Calling this method alters the state of the builder. Further rules should not be added to this builder once this method is called.

    zoneId

    the time-zone ID, not null

    returns

    the zone rules, not null

    Exceptions thrown

    IllegalStateException if there is only one rule defined as being forever for any given window

  23. def toString(): String
    Definition Classes
    AnyRef → Any
  24. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  25. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  26. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()

Inherited from AnyRef

Inherited from Any

Ungrouped