Дата

нет пакета

Доступно на всех платформах

Класс Date предоставляет базовую структуру для информации о дате и времени. Экземпляры Date могут быть созданы

• new Date() для указанной даты,
• Date.now() для получения информации о текущем времени,
• Date.fromTime() с заданным временным отметкой или
• Date.fromString() путем парсинга из строки.

В классе DateTools доступны дополнительные функции.

В контексте дат Haxe временная отметка определяется как количество миллисекунд, прошедших с 1 января 1970 года по UTC.

Поддерживаемый диапазон

Из-за ограничений платформы, даты в диапазоне с 1970 по 2038 года поддерживаются последовательно. Некоторые целевые платформы могут поддерживать даты за пределами этого диапазона, в зависимости от операционной системы во время выполнения. Метод Date.fromTime не будет работать с временными отметками за пределами диапазона на любой платформе.

Статические методы

staticfromString(s:String):Date

Создает дату из отформатированной строки s. Функция принимает следующие форматы:

• "YYYY-MM-DD hh:mm:ss"
• "YYYY-MM-DD"
• "hh:mm:ss"

Два первых формата представляют дату в локальном времени. Третий — время относительно эпохи UTC.

staticfromTime(t:Float):Date

Создает дату из временной метки (в миллисекундах) t.

staticnow():Date

Возвращает дату, представляющую текущее локальное время.

Конструктор

new(year:Int, month:Int, day:Int, hour:Int, min:Int, sec:Int)

Создает новый объект даты из заданных аргументов.

Поведение экземпляра Date согласованно на всех платформах, только если аргументы описывают корректную дату.

• месяц: от 0 до 11 (обратите внимание, что это нумерация с нуля)
• день: от 1 до 31
• час: от 0 до 23
• минута: от 0 до 59
• секунда: от 0 до 59

Методы

getDate():Int

Возвращает день this даты (диапазон 1-31) в локальной часовой зоне.

getDay():Int

Возвращает день недели this даты (диапазон 0-6, где 0 — это воскресенье) в локальной часовой зоне.

getFullYear():Int

Возвращает полный год this даты (4 цифры) в локальной часовой зоне.

getHours():Int

Возвращает часы this даты (диапазон 0-23) в локальной часовой зоне.

getMinutes():Int

Возвращает минуты this даты (диапазон 0-59) в локальной часовой зоне.

getMonth():Int

Возвращает месяц this даты (диапазон 0-11) в локальной часовой зоне. Обратите внимание, что номер месяца нулевой.

getSeconds():Int

Возвращает секунды this даты (диапазон 0-59) в локальной часовой зоне.

getTime():Float

Возвращает временную метку (в миллисекундах) this даты. В cpp и neko эта функция имеет разрешение только в секунды, поэтому результат всегда будет кратен 1000.0, например, 1454698271000.0. Чтобы получить текущую временную метку с большей точностью в cpp и neko, обратитесь к API Sys.time.

Для измерения разницы во времени с точностью до миллисекунды на всех платформах, см. haxe.Timer.stamp.

getTimezoneOffset():Int

Возвращает разницу часовых поясов this даты в текущем регионе по отношению к UTC в минутах.

Предполагая, что функция выполняется на машине в часовом поясе UTC+2, Date.now().getTimezoneOffset() вернет -120.

getUTCDate():Int

Возвращает день this даты (диапазон 1-31) в UTC.

getUTCDay():Int

Возвращает день недели this даты (диапазон 0-6, где 0 — это воскресенье) в UTC.

getUTCFullYear():Int

Возвращает полный год this даты (4 цифры) в UTC.

getUTCHours():Int

Возвращает часы this даты (диапазон 0-23) в UTC.

getUTCMinutes():Int

Возвращает минуты this даты (диапазон 0-59) в UTC.

getUTCMonth():Int

Возвращает месяц this даты (диапазон 0-11) в UTC. Обратите внимание, что номер месяца нулевой.

getUTCSeconds():Int

Возвращает секунды this даты (диапазон 0-59) в UTC.

toString():String

Возвращает строковое представление this даты в локальной часовой зоне в стандартном формате YYYY-MM-DD HH:MM:SS. См. DateTools.format для других правил форматирования.