Spec-Zone.ru › OpenJDK 8

Класс JulianFields

  • java.lang.Object
    • java.time.temporal.JulianFields

public final class JulianFields
extends Object

Набор полей даты, предоставляющих доступ к дням Джулиана.

День Джулиана — стандартный способ выражения даты и времени, обычно используемый в научном сообществе. Он выражается как десятичное число целых дней, где дни начинаются в полдень. Этот класс представляет собой вариации дней Джулиана, которые считают целые дни с полуночи.

Поля реализованы относительно EPOCH_DAY. Поля поддерживаются и могут быть запрошены и установлены, если EPOCH_DAY доступно. Поля работают со всеми хронологиями.

Требования к реализации:
Это неизменяемый и потокобезопасный класс.
С:
1.8

Поля

Модификатор и тип Поле и описание
static TemporalField JULIAN_DAY

Поле дня Джулиана.

static TemporalField MODIFIED_JULIAN_DAY

Поле модифицированного дня Джулиана.

static TemporalField RATA_DIE

Поле Rata Die.

Методы

Методы, унаследованные от класса java.lang.Object

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

Поля

JULIAN_DAY

public static final TemporalField JULIAN_DAY

Поле дня Джулиана.

Это целочисленная версия числа дня Джулиана. День Джулиана — хорошо известная система, представляющая собой счёт целых дней с момента дня 0, который определяется как 1 января 4713 г. до н. э. в юлианском календаре и 24 ноября 4713 г. до н. э. в григорианском. Поле имеет «JulianDay» в качестве «имени» и «DAYS» в качестве «baseUnit». Поле всегда относится к локальному времени, игнорируя смещение или часовой пояс.

Для дат и времени «JULIAN_DAY.getFrom()» предполагает одинаковое значение с полуночи до момента перед следующей полуночью. При применении «JULIAN_DAY.adjustInto()» к дате и времени часть времени суток остается неизменной. «JULIAN_DAY.adjustInto()» и «JULIAN_DAY.getFrom()» применяются только к объектам Temporal, которые могут быть преобразованы в ChronoField.EPOCH_DAY. Для любого другого типа объекта выбрасывается исключение UnsupportedTemporalTypeException.

На фазе разрешения при разборе дата может быть создана из поля дня Джулиана. В строгом режиме и умном режиме значение дня Джулиана проверяется на соответствие диапазону допустимых значений. В мягком режиме проверка не выполняется.

Примечания по астрономии и науке

Стандартное астрономическое определение использует дробь для указания времени суток, поэтому 3,25 представляют время 18:00, поскольку дни начинаются в полдень. Эта реализация использует целое число и дни, начинающиеся в полночь. Целочисленное значение для числа дня Джулиана — это значение астрономического дня Джулиана в полдень интересующей даты. Это равно астрономическому дню Джулиана, округлённому до целого числа JDN = floor(JD + 0.5).
| ISO date          |  Julian Day Number | Astronomical Julian Day |
  | 1970-01-01T00:00  |         2,440,588  |         2,440,587.5     |
  | 1970-01-01T06:00  |         2,440,588  |         2,440,587.75    |
  | 1970-01-01T12:00  |         2,440,588  |         2,440,588.0     |
  | 1970-01-01T18:00  |         2,440,588  |         2,440,588.25    |
  | 1970-01-02T00:00  |         2,440,589  |         2,440,588.5     |
  | 1970-01-02T06:00  |         2,440,589  |         2,440,588.75    |
  | 1970-01-02T12:00  |         2,440,589  |         2,440,589.0     |

Иногда дни Джулиана предполагают всемирное время или UTC, но эта реализация всегда использует число дня Джулиана для локальной даты независимо от смещения или часового пояса.

MODIFIED_JULIAN_DAY

public static final TemporalField MODIFIED_JULIAN_DAY

Поле модифицированного дня Джулиана.

Это целочисленная версия числа модифицированного дня Джулиана. Модифицированный день Джулиана (MJD) — хорошо известная система, которая считает дни непрерывно. Она определяется относительно астрономического дня Джулиана как MJD = JD - 2400000.5. Каждый модифицированный день Джулиана длится с полуночи до полуночи. Поле всегда относится к локальному времени, игнорируя смещение или часовой пояс.

Для дат и времени «MODIFIED_JULIAN_DAY.getFrom()» предполагает одинаковое значение с полуночи до момента перед следующей полуночью. При применении «MODIFIED_JULIAN_DAY.adjustInto()» к дате и времени часть времени суток остается неизменной. «MODIFIED_JULIAN_DAY.adjustInto()» и «MODIFIED_JULIAN_DAY.getFrom()» применяются только к объектам Temporal, которые могут быть преобразованы в ChronoField.EPOCH_DAY. Для любого другого типа объекта выбрасывается исключение UnsupportedTemporalTypeException.

Эта реализация — целочисленная версия MJD с дробной частью, округлённой до ближайшего целого.

На фазе разрешения при разборе дата может быть создана из поля модифицированного дня Джулиана. В строгом режиме и умном режиме значение модифицированного дня Джулиана проверяется на соответствие диапазону допустимых значений. В мягком режиме проверка не выполняется.

Примечания по астрономии и науке

| ISO date          | Modified Julian Day |      Decimal MJD |
  | 1970-01-01T00:00  |             40,587  |       40,587.0   |
  | 1970-01-01T06:00  |             40,587  |       40,587.25  |
  | 1970-01-01T12:00  |             40,587  |       40,587.5   |
  | 1970-01-01T18:00  |             40,587  |       40,587.75  |
  | 1970-01-02T00:00  |             40,588  |       40,588.0   |
  | 1970-01-02T06:00  |             40,588  |       40,588.25  |
  | 1970-01-02T12:00  |             40,588  |       40,588.5   |
Модифицированные дни Джулиана иногда предполагают всемирное время или UTC, но эта реализация всегда использует модифицированный день Джулиана для локальной даты независимо от смещения или часового пояса.

RATA_DIE

public static final TemporalField RATA_DIE

Поле Rata Die.

Rata Die считает целые дни непрерывно, начиная с дня 1 в полночь в начале 0001-01-01 (ISO). Поле всегда относится к локальному времени, игнорируя смещение или часовой пояс.

Для дат и времени «RATA_DIE.getFrom()» предполагает одинаковое значение с полуночи до момента перед следующей полуночью. При применении «RATA_DIE.adjustInto()» к дате и времени часть времени суток остается неизменной. «RATA_DIE.adjustInto()» и «RATA_DIE.getFrom()» применяются только к объектам Temporal, которые могут быть преобразованы в ChronoField.EPOCH_DAY. Для любого другого типа объекта выбрасывается исключение UnsupportedTemporalTypeException.

На фазе разрешения при разборе дата может быть создана из поля Rata Die. В строгом режиме и умном режиме значение Rata Die проверяется на соответствие диапазону допустимых значений. В мягком режиме проверка не выполняется.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API