Класс JulianFields

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, но данная реализация всегда использует число дня Джулиана для локальной даты, независимо от смещения или часового пояса.

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, но данная реализация всегда использует изменённый день Джулиана для локальной даты, независимо от смещения или часового пояса.

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 проверяется на соответствие диапазону допустимых значений. В мягком режиме проверка не выполняется.