Класс JulianFields

public final class JulianFields
extends Object

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

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

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

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

Поля

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

Поле юлианского дня.

static TemporalFieldMODIFIED_JULIAN_DAY

Поле модифицированного юлианского дня.

static TemporalFieldRATA_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» как «базовую единицу». Поле всегда относится к локальному времени, игнорируя смещение или часовой пояс.

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

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

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

Стандартное астрономическое определение использует дробь для указания времени суток, где каждый день считается с полудня до полудня. Например, дробь 0 соответствует полудню, дробь 0,25 — 18:00, дробь 0,5 — полуночи, а дробь 0,75 — 06: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

Поле модифицированного юлианского дня.

Это целочисленная версия номера модифицированного юлианского дня. Модифицированный юлианский день (МJD) — хорошо известная система, которая считает дни непрерывно. Он определен относительно астрономического юлианского дня как 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.

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

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

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

| 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/temporal/JulianFields.html

Spec-Zone .ru
спецификации, руководства, описания, API