Функции обработки даты/времени

Раздел описывает функции языка выражений, относящиеся к обработке временных меток.

Функция

Описание

Тип результата

date(Integer year, Integer month, Integer day, Integer hour, Integer minute, Integer second [, Integer millisecond [, String timezone]])

Формирует дату по заданным значениям года, месяца, дня, часа, минуты и секунды. Имейте в виду, что месяц отсчитывается с нуля, т.е. значение Января равно 0.

Временная зона по умолчанию, используемая для построения временных меток - UTC. Пользовательские временные зоны могут задаваться в форме строки, например:

  • GMT-8
  • GMT-08:00
  • America/Los_Angeles

Date

dateAdd(Date date, Integer count, String unit [, String timezone])

Добавляет число периодов времени, заданное в упомянутых выше единицах, к дате, и возвращает результат. См. названия единиц выше.

Временная зона по умолчанию - UTC. Пользовательские временные зоны могут задаваться в форме строки, например:

  • GMT-8
  • GMT-08:00
  • America/Los_Angeles

Date

dateDiff(Date first, Date second, String unit)

Рассчитывает время, прошедшее с первой даты до второй, измеряемое в:

  • millisecond или ms для миллисекунд
  • second, sec или s для Секунд
  • minute, min или m для Минут
  • hour, hr или h для Часов
  • day или d для Дней
  • week или w для Недель
  • month для Месяцев (Имейте в виду, что  месяц с нулевой базой, т.е. значение для Января равно 0.)
  • year или y для Лет.

Long

day(Date date [, String timezone])

Возвращает день заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

dayOfWeek(Date date [, String timezone])

Возвращает день недели заданной временной метки (1 для воскресенья). См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

dayOfYear(Date date [, String timezone])

Возвращает день года заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

formatDate(Date date, String pattern [, String timezone])

Форматирует значение Даты в Строку. Образцы форматирования даты описаны здесь.

Временная зона по умолчанию, используемая для форматирования временных меток - UTC. Пользовательские временные зоны могут задаваться в форме строки, например:

  • GMT-8
  • GMT-08:00
  • America/Los_Angeles

Для форматирования даты в строку, подходящую для перестройки Таблицы Данных из списка параметров строки, используйте следующий образец: yyyy-MM-dd HH:mm:ss.SSS.

String

hour(Date date [, String timezone])

Возвращает час заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

millisecond(Date date)

Возвращает миллисекунду заданной временной метки.

Integer

minute(Date date [, String timezone])

Возвращает минуту заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

month(Date date [, String timezone])

Возвращает месяц заданной временной метки (0 для Января). См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer

now()

Возвращает текущую дату/время.

Date

second(Date date)

Возвращает секунду заданной временной метки.

Integer

parseDate(String source, String pattern [, String timezone])

Разбирает значение Даты из Строки. Шаблоны дат описаны здесь.

Временная зона по умолчанию, используемая для построения временных меток - UTC. Пользовательские временные зоны могут задаваться в форме строки, например:

  • GMT-8
  • GMT-08:00
  • America/Los_Angeles

String

printPeriod(Long period [, minUnit [, maxUnit]])

Интеллектуально форматирует временной период (выраженный в миллисекундах) в строку в следующей форме: X days X hours X minutes X seconds. minUnit и maxUnit - это минимальные и максимальные типы целых единиц для использования в отрисовке и редактировании периода. Доступные единицы описаны здесь, единицы Неделя и Квартал не поддерживаются.

String

time(Date date)

Возвращает число миллисекунд с Начала отчета для заданной временной точки.

Long

year(Date date [, String timezone])

Возвращает год заданной временной метки. См. описание функции formatDate, чтобы узнать, как установить определенную временную зону.

Integer