Класс JulianFields

public static final TemporalField JULIAN_DAY

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

Это целочисленная версия числа дня Джулиана. День Джулиана — хорошо известная система, которая представляет собой количество целых дней с дня 0, который определяется как 1 января 4713 года до нашей эры в юлианском календаре, и -4713-11-24 в григорианском. Поле имеет «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 — 6: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 = JD - 2400000.5. Каждый модифицированный день Джулиана длится с полуночи до полуночи. Поле всегда относится к местному времени, игнорируя смещение или часовой пояс.

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

В данной реализации используется целочисленная версия МДЖ с дробной частью, округленной до ближайшего меньшего целого.

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

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

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