| Пакет | Верхний уровень |
| Класс | public final dynamic class Date |
| Наследование | Date  Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Date.UTC() и Date.parse() представляют собой исключение, являясь статическими.
Класс Date по-разному обрабатывает переход на летнее время в зависимости от операционной системы и версии среды выполнения. Flash Player версии 6 и выше учитывает переход на летнее время в следующих операционных системах.
- Windows – объект Date автоматически корректирует выводимые данные с учетом перехода на летнее время. Объект Date распознает ситуации, когда переход на летнее время включен в текущем регионе. При этом регистрируется стандартная дата и время данного перехода. Однако даты переходов, выбранные в данный момент, применяются к датам в прошлом и будущем, поэтому расчет временного сдвига может выполняться с ошибкой для прошедших дат, приходящихся на период действия других дат перехода для этого региона.
- Mac OS X – объект Date автоматически корректирует выводимые данные с учетом перехода на летнее время. Информационная база данных о часовых поясах используется в Mac OS X, чтобы определять, необходимо ли применять сдвиг по времени к любым текущим или прошедшим дате и времени.
- Mac OS 9 – в этой операционной системе приводятся сведения, которых достаточно только для определения того, необходимо ли применять временной сдвиг к текущим дате и времени. Исходя из этого, объект Date допускает, что текущий временной сдвиг применяется ко всем прошедшим или еще не наступившим датам.
Переход на летнее время обрабатывается Flash Player 5 в следующих операционных системах.
- В Windows всегда применяются правила перехода на летнее время для США. Это приводит к ошибкам в Европе и других странах, где переход на летнее время принят, но происходит в другой день, нежели в США. Flash правильно определяет, принят ли переход на летнее время в том или ином регионе.
Чтобы воспользоваться классом Date, создайте экземпляр Date с помощью оператора new.
В ActionScript 3.0 добавлено несколько новых свойств средств доступа, которыми можно пользоваться вместо многих методов класса Date, которые выполняют доступ к экземплярам Date или модифицируют их. Также ActionScript 3.0 содержит ряд новых вариантов метода toString(), добавленных в целях соответствия третьему изданию ECMA-262, включая: Date.toLocaleString(), Date.toTimeString(), Date.toLocaleTimeString(), Date.toDateString() и Date.toLocaleDateString().
Чтобы вычислить относительное или прошедшее время, воспользуйтесь методом getTimer() из пакета flash.utils.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| date : Number
День месяца по местному времени (целое число от 1 до 31), заданный объектом Date. | Date | ||
| dateUTC : Number
День месяца (целое число от 1 до 31) по всемирному скоординированному времени (UTC) из объекта Date. | Date | ||
| day : Number [только для чтения]
День недели по местному времени (0 – воскресенье, 1 – понедельник и т. д.), заданный объектом Date. | Date | ||
| dayUTC : Number [только для чтения]
День недели (0 – воскресенье, 1 – понедельник и т. д.) по всемирному скоординированному времени (UTC) из объекта Date. | Date | ||
| fullYear : Number
Полный год (четырехзначное число, например 2000) объекта Date по местному времени. | Date | ||
| fullYearUTC : Number
Четырехзначный год по всемирному скоординированному времени (UTC) из объекта Date. | Date | ||
| hours : Number
Час дня по местному времени (целое число от 0 до 23) из объекта Date. | Date | ||
| hoursUTC : Number
Час дня (целое число от 0 до 23) по всемирному скоординированному времени (UTC) из объекта Date. | Date | ||
| milliseconds : Number
Число миллисекунд по местному времени (целое число от 0 до 999) из объекта Date. | Date | ||
| millisecondsUTC : Number
Число миллисекунд (целое число от 0 до 999) по всемирному скоординированному времени (UTC) из объекта Date. | Date | ||
| minutes : Number
Число минут по местному времени (целое число от 0 до 59) из объекта Date. | Date | ||
| minutesUTC : Number
Число минут (целое число от 0 до 59) по всемирному скоординированному времени (UTC) из объекта Date. | Date | ||
| month : Number
Месяц (0 – январь, 1 – февраль и т. д.) объекта Date по местному времени. | Date | ||
| monthUTC : Number
Месяц (от 0 [январь] до 11 [декабрь]) по всемирному скоординированному времени (UTC) из объекта Date. | Date | ||
| seconds : Number
Число секунд по местному времени (целое число от 0 до 59) из объекта Date. | Date | ||
| secondsUTC : Number
Число секунд (целое число от 0 до 59) по всемирному скоординированному времени (UTC) из объекта Date. | Date | ||
| time : Number
Число миллисекунд с полуночи 1 января 1970 года по всемирному скоординированному времени для объекта Date. | Date | ||
| timezoneOffset : Number [только для чтения]
Разница в минутах между местным временем компьютера и временем по всемирному скоординированному времени (UTC). | Date | ||
| Метод | Определено | ||
|---|---|---|---|
Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)
Создает новый объект Date, который содержит заданную дату и время. | Date | ||
Возвращает день месяца по местному времени (целое число от 1 до 31), заданный объектом Date. | Date | ||
Возвращает день недели по местному времени (0 – воскресенье, 1 – понедельник, и т.д.), заданный объектом Date. | Date | ||
Возвращает из объекта Date полный год по местному времени (четырехзначное число, например 2000). | Date | ||
Возвращает час (целое число от 0 до 23) дня, относящегося к объекту Date, по местному времени. | Date | ||
Возвращает из объекта Date число миллисекунд по местному времени (целое число от 0 до 999). | Date | ||
Возвращает из объекта Date число минут по местному времени (целое число от 0 до 59). | Date | ||
Возвращает из объекта Date месяц по местному времени (0 – январь, 1 – февраль и т.д.). | Date | ||
Возвращает из объекта Date число секунд по местному времени (целое число от 0 до 59). | Date | ||
Возвращает для объекта Date число миллисекунд с полуночи 1 января 1970 года по всемирному скоординированному времени. | Date | ||
Возвращает разницу в минутах между местным временем компьютера и всемирным скоординированным временем (UTC). | Date | ||
Возвращает из объекта Date день месяца (целое число от 1 до 31) по всемирному скоординированному времени (UTC). | Date | ||
Возвращает из объекта Date день недели (0 – воскресенье, 1 – понедельник и т. д.) по всемирному скоординированному времени (UTC). | Date | ||
Возвращает из объекта Date четырехзначный год по всемирному скоординированному времени (UTC). | Date | ||
Возвращает из объекта Date час дня (целое число от 0 до 23) по всемирному скоординированному времени (UTC). | Date | ||
Возвращает из объекта Date число миллисекунд (целое число от 0 до 999) по всемирному скоординированному времени (UTC). | Date | ||
Возвращает из объекта Date число минут (целое число от 0 до 59) по всемирному скоординированному времени (UTC). | Date | ||
Возвращает из объекта Date месяц (от 0 [январь] до 11 [декабрь]) по всемирному скоординированному времени (UTC). | Date | ||
Возвращает из объекта Date число секунд (целое число от 0 до 59) по всемирному скоординированному времени (UTC). | Date | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
[статические]
Преобразует строку, представляющую дату, в число, равное количеству миллисекунд с полуночи 1 января 1970 года по Гринвичу (UTC). | Date | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
Задает день месяца по местному времени и возвращает новое время в миллисекундах. | Date | ||
Задает год по местному времени и возвращает новое время в миллисекундах. | Date | ||
Задает час по местному времени и возвращает новое время в миллисекундах. | Date | ||
Задает количество миллисекунд по местному времени и возвращает новое время в миллисекундах. | Date | ||
Задает количество минут по местному времени и возвращает новое время в миллисекундах. | Date | ||
Задает месяц и (при необходимости) день месяца по местному времени и возвращает новое время в миллисекундах. | Date | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
Задает количество секунд по местному времени и возвращает новое время в миллисекундах. | Date | ||
Задает дату в миллисекундах с полуночи 1 января 1970 года и возвращает новое время в миллисекундах. | Date | ||
Задает день месяца по Гринвичу (UTC) и возвращает новое время в миллисекундах. | Date | ||
Задает год по Гринвичу (UTC) и возвращает новое время в миллисекундах. | Date | ||
Задает час по Гринвичу (UTC) и возвращает новое время в миллисекундах. | Date | ||
Задает количество миллисекунд по Гринвичу (UTC) и возвращает новое время в миллисекундах. | Date | ||
Задает количество минут по Гринвичу (UTC) и возвращает новое время в миллисекундах. | Date | ||
Задает месяц и (при необходимости) день месяца по Гринвичу (UTC) и возвращает новое время в миллисекундах. | Date | ||
Задает количество секунд и (при необходимости) миллисекунд по Гринвичу (UTC) и возвращает новое время в миллисекундах. | Date | ||
Возвращает строковое представление дня и даты без времени или часового пояса. | Date | ||
Предоставляет переопределяемый метод, позволяющий настраивать кодировку JSON значений в объекте Date. | Date | ||
Возвращает строковое представление дня и даты без времени или часового пояса. | Date | ||
Возвращает строковое представление дня, даты и времени по местному времени. | Date | ||
Возвращает строковое представление времени без дня, даты, года или часового пояса. | Date | ||
Возвращает строковое представление дня, даты, времени и часового пояса. | Date | ||
Возвращает строковое представление времени и часового пояса без дня и даты. | Date | ||
Возвращает строковое представление дня, даты и времени по Гринвичу (UTC). | Date | ||
UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number [статические]
Возвращает число миллисекунд от полуночи 1 января 1970 года по Гринвичу до момента, заданного параметрами. | Date | ||
Возвращает для объекта Date число миллисекунд с полуночи 1 января 1970 года по всемирному скоординированному времени. | Date | ||
date | свойство |
date:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
День месяца по местному времени (целое число от 1 до 31), заданный объектом Date. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Реализация
AS3 function get date():Number AS3 function set date(value:Number):voidСвязанные элементы API
dateUTC | свойство |
dateUTC:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
День месяца (целое число от 1 до 31) по всемирному скоординированному времени (UTC) из объекта Date.
Реализация
AS3 function get dateUTC():Number AS3 function set dateUTC(value:Number):voidСвязанные элементы API
day | свойство |
day:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
День недели по местному времени (0 — воскресенье, 1 — понедельник и т. д.), заданный объектом Date. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Реализация
AS3 function get day():NumberСвязанные элементы API
dayUTC | свойство |
dayUTC:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
День недели (0 – воскресенье, 1 – понедельник и т. д.) по всемирному скоординированному времени (UTC) из объекта Date.
Реализация
AS3 function get dayUTC():NumberСвязанные элементы API
fullYear | свойство |
fullYear:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Полный год (четырехзначное число, например 2000) объекта Date по местному времени. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Реализация
AS3 function get fullYear():Number AS3 function set fullYear(value:Number):voidСвязанные элементы API
fullYearUTC | свойство |
fullYearUTC:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Четырехзначный год по всемирному скоординированному времени (UTC) из объекта Date.
Реализация
AS3 function get fullYearUTC():Number AS3 function set fullYearUTC(value:Number):voidСвязанные элементы API
hours | свойство |
hours:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Час дня по местному времени (целое число от 0 до 23) из объекта Date. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Реализация
AS3 function get hours():Number AS3 function set hours(value:Number):voidСвязанные элементы API
hoursUTC | свойство |
hoursUTC:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Час дня (целое число от 0 до 23) по всемирному скоординированному времени (UTC) из объекта Date.
Реализация
AS3 function get hoursUTC():Number AS3 function set hoursUTC(value:Number):voidСвязанные элементы API
milliseconds | свойство |
milliseconds:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Число миллисекунд по местному времени (целое число от 0 до 999) из объекта Date. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Реализация
AS3 function get milliseconds():Number AS3 function set milliseconds(value:Number):voidСвязанные элементы API
millisecondsUTC | свойство |
millisecondsUTC:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Число миллисекунд (целое число от 0 до 999) по всемирному скоординированному времени (UTC) из объекта Date.
Реализация
AS3 function get millisecondsUTC():Number AS3 function set millisecondsUTC(value:Number):voidСвязанные элементы API
minutes | свойство |
minutes:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Число минут по местному времени (целое число от 0 до 59) из объекта Date. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Реализация
AS3 function get minutes():Number AS3 function set minutes(value:Number):voidСвязанные элементы API
minutesUTC | свойство |
minutesUTC:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Число минут (целое число от 0 до 59) по всемирному скоординированному времени (UTC) из объекта Date.
Реализация
AS3 function get minutesUTC():Number AS3 function set minutesUTC(value:Number):voidСвязанные элементы API
month | свойство |
month:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Месяц (0 — январь, 1 — февраль и т. д.) объекта Date по местному времени. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Реализация
AS3 function get month():Number AS3 function set month(value:Number):voidСвязанные элементы API
monthUTC | свойство |
monthUTC:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Месяц (от 0 [январь] до 11 [декабрь]) по всемирному скоординированному времени (UTC) из объекта Date.
Реализация
AS3 function get monthUTC():Number AS3 function set monthUTC(value:Number):voidСвязанные элементы API
seconds | свойство |
seconds:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Число секунд по местному времени (целое число от 0 до 59) из объекта Date. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Реализация
AS3 function get seconds():Number AS3 function set seconds(value:Number):voidСвязанные элементы API
secondsUTC | свойство |
secondsUTC:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Число секунд (целое число от 0 до 59) по всемирному скоординированному времени (UTC) из объекта Date.
Реализация
AS3 function get secondsUTC():Number AS3 function set secondsUTC(value:Number):voidСвязанные элементы API
time | свойство |
time:Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Число миллисекунд с полуночи 1 января 1970 года по всемирному скоординированному времени для объекта Date. Воспользуйтесь этим методом, чтобы представить определенный момент во времени при сравнении двух и более объектов Date.
Реализация
AS3 function get time():Number AS3 function set time(value:Number):voidСвязанные элементы API
timezoneOffset | свойство |
timezoneOffset:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Разница в минутах между местным временем компьютера и временем по всемирному скоординированному времени (UTC). В частности, это значение представляет собой количество минут, которое необходимо добавить к местному времени компьютера, чтобы оно стало равно всемирному. Если время компьютера опережает UTC, значение будет отрицательным.
Реализация
AS3 function get timezoneOffset():NumberСвязанные элементы API
Date | () | Конструктор |
public function Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Создает новый объект Date, который содержит заданную дату и время.
Конструктор Date() может иметь до 7 параметров (year, month, ..., millisecond), позволяющих указывать дату и время с точностью до миллисекунды. Дата, которую содержит только что созданный объект Date зависит от количества и типа данных переданных аргументов.
- Если аргументы не указываются, объекту Date присваивается текущие дата и время.
- Если передается один аргумент с типом данных Number, объекту Date присваивается временное значение, исходя из количества миллисекунд, прошедших с 0:00:000 1 января 1970 года (среднее время по Гринвичу) и указанных в этом единственном аргументе.
- Если передается один аргумент с типом данных String, и в этой строке есть действительная дата, объект Date содержит временное значение, основанное на этой дате.
- При передаче двух и большего числа аргументов объекту Date присваивается временное значение на основе переданных значений аргумента, которые относятся к году, месяцу, дате, часу, минуте, секунде и миллисекундам.
Если конструктору класса Date передается строка, дата может быть представлена в разных форматах, но должна включать, по крайней мере, месяц, дату и год. Например, Feb 1 2005 (1 февраля 2005 г.) – это действительное значение в отличие от Feb 2005 (февраль 2005 г.). В списке ниже приведены некоторые действительные форматы:
- «День Месяц Дата Часы:Минуты:Секунды GMT Год» (например, значение «Tue Feb 1 00:00:00 GMT-0800 2005», совпадающее со значением
toString()) - «День Месяц Дата Год Часы:Минуты:Секунды AM/PM» (например, значение «Tue Feb 1 2005 12:00:00 AM», совпадающее со значением
toLocaleString()) - «День Месяц Дата Год» (например, значение «Tue Feb 1 2005», совпадающее со значением
toDateString()) - Месяц/День/Год (например, «02/01/2005»)
- Месяц/Год (например, «02/2005»)
yearOrTimevalue:Object — Если указаны другие параметры, это число выражает год (например, 1965); в противном случае оно представляет собой временное значение. Если данное число относится к году, значения с 0 до 99 указывают на 1900-1999 гг.; в противном случае необходимо указывать все четыре цифры года. Если число представляет собой временное значение (без дополнительно указанных параметров), оно отражает количество миллисекунд до или после 0:00:00 1 января 1970 г. (среднее время по Гринвичу); отрицательные значения отражают время до 0:00:00 1 января 1970 г. (среднее время по Гринвичу), а положительное значение указывает на время после этой даты.
| |
month:Number — Целое число от 0 (январь) до 11 (декабрь).
| |
date:Number (default = 1) | |
hour:Number (default = 0) | |
minute:Number (default = 0) | |
second:Number (default = 0) | |
millisecond:Number (default = 0) |
Связанные элементы API
getDate | () | метод |
AS3 function getDate():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает день месяца по местному времени (целое число от 1 до 31), заданный объектом Date. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Number — День месяца (1 – 31), который представляет объект Date.
|
Связанные элементы API
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Затем вызывается метод getDate(), определяющий день месяца.
package {
import flash.display.Sprite;
public class DateExample extends Sprite {
public function DateExample() {
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDate()); // 30
}
}
}
getDay | () | метод |
AS3 function getDay():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает день недели по местному времени (0 — воскресенье, 1 — понедельник и т.д.), заданный объектом Date. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Number — Числовая версия дня недели (0 – 6), который представляет объект Date.
|
Пример ( Использование этого примера )
weekDayLabels с элементами [Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday] и новый объект Date someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). После этого дважды вызывается метод getDay(), который сначала показывает число месяца в виде цифры 6, а затем показывает день недели с помощью weekDayLabels.
var weekDayLabels:Array = new Array("Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday");
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDay()); // 6
trace(weekDayLabels[someBirthday.getDay()]); // Saturday
getFullYear | () | метод |
AS3 function getFullYear():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date полный год по местному времени (четырехзначное число, например 2000). Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Number — Полный год, который представляет объект Date.
|
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). После этого вызывается метод getFullYear(), который извлекает четырехзначное обозначение года.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getFullYear()); // 1974
getHours | () | метод |
AS3 function getHours():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает час (целое число от 0 до 23) дня, относящегося к объекту Date, по местному времени. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Number — Час (0 – 23) дня, представленного объектом Date.
|
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Затем вызываются методы getHours() и getMinutes(), которые извлекают часы и минуты в 24-часовом формате. В итоге создается строка localTime, которая присваивается результату вызова функции getUSClockTime(), которая, в свою очередь, снова вызывает методы getHours() и getMinutes(), указывающее время 03:05 PM.
var someBirthday:Date = new Date(1974, 10, 30, 15, 5);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5
var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes());
trace(localTime); // 03:05 PM
function getUSClockTime(hrs:uint, mins:uint):String {
var modifier:String = "PM";
var minLabel:String = doubleDigitFormat(mins);
if(hrs > 12) {
hrs = hrs-12;
} else if(hrs == 0) {
modifier = "AM";
hrs = 12;
} else if(hrs < 12) {
modifier = "AM";
}
return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier);
}
function doubleDigitFormat(num:uint):String {
if(num < 10) {
return ("0" + num);
}
return num as String;
}
getMilliseconds | () | метод |
AS3 function getMilliseconds():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date число миллисекунд по местному времени (целое число от 0 до 999). Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Number — Фрагмент объекта Date с миллисекундами.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getMilliseconds(), который извлекает из объекта Date now число миллисекунд на момент создания
var now:Date = new Date(); trace(now.getMilliseconds());
getMinutes | () | метод |
AS3 function getMinutes():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date число минут по местному времени (целое число от 0 до 59). Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Number — Фрагмент объекта Date с минутами.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getMinutes(), который извлекает из объекта Date now число миллисекунд на момент создания
var now:Date = new Date(); trace(now); trace(now.getMinutes());
getMonth | () | метод |
AS3 function getMonth():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date месяц по местному времени (0 — январь, 1 — февраль и т.д.). Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Number — Фрагмент объекта Date с месяцем (0 - 11).
|
Пример ( Использование этого примера )
monthLabels с элементами от January до December и новый объект Date now без параметров. Затем дважды вызывается метод getMonth(), который сначала возвращает номер месяца, а затем указывает месяц создания объекта Date now.
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(monthLabels[now.getMonth()]);
getSeconds | () | метод |
AS3 function getSeconds():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date число секунд по местному времени (целое число от 0 до 59). Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Number — Фрагмент объекта Date с секундами (от 0 до 59).
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getSeconds(), который извлекает из объекта Date now число миллисекунд на момент создания.
var now:Date = new Date(); trace(now.getSeconds());
getTime | () | метод |
AS3 function getTime():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает для объекта Date число миллисекунд с полуночи 1 января 1970 года по всемирному скоординированному времени. Воспользуйтесь этим методом, чтобы представить определенный момент во времени при сравнении двух и более объектов Date.
Number — Количество миллисекунд с 1 января 1970 г., выражаемых объектом Date.
|
Пример ( Использование этого примера )
mlk с параметрами year (1929), month (0 = январь) и day (15). Затем вызывается метод getTime(), который извлекает количество миллисекунд, прошедших с 1 января 1970 г. Это отрицательное число, поскольку выбран 1929 г.
var mlk:Date = new Date(1929, 0, 15); trace(mlk); // Tue Jan 15 00:00:00 GMT-0800 1929 trace(mlk.getTime()); // -1292601600000
now без параметров, а затем используются следующие методы класса DateMath (созданные ниже), добавляющие время в исходный объект Date now, прошедшее с момента его создания:
addSeconds(): добавляет 30 секунд к объектуnow.addMinutes(): добавляет 30 минут к объектуnow.addHours(): добавляет 6 часов к объекту Datenow.addHours(): добавляет 30 дней к объекту Datenow.addWeeks(): добавляет 4 недели к объектуnow.
var now:Date = new Date();
trace(now);
trace(DateMath.addSeconds(now, 30));
trace(DateMath.addMinutes(now, 30));
trace(DateMath.addHours(now, 6));
trace(DateMath.addDays(now, 30));
trace(DateMath.addWeeks(now, 4));
class DateMath {
public static function addWeeks(date:Date, weeks:Number):Date {
return addDays(date, weeks*7);
}
public static function addDays(date:Date, days:Number):Date {
return addHours(date, days*24);
}
public static function addHours(date:Date, hrs:Number):Date {
return addMinutes(date, hrs*60);
}
public static function addMinutes(date:Date, mins:Number):Date {
return addSeconds(date, mins*60);
}
public static function addSeconds(date:Date, secs:Number):Date {
var mSecs:Number = secs * 1000;
var sum:Number = mSecs + date.getTime();
return new Date(sum);
}
}
function addMonths(num:Number):void {
currentMonth = currentMonth + num;
if(currentMonth > 12) {
currentYear++;
currentMonth = currentMonth - 12;
}
}
getTimezoneOffset | () | метод |
AS3 function getTimezoneOffset():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает разницу в минутах между местным временем компьютера и всемирным скоординированным временем (UTC).
ВозвращаетNumber — Число минут, которые необходимо добавить к значению местного времени компьютера, чтобы оно равнялось UTC. Если время компьютера опережает UTC, возвращается отрицательное значение.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getTimezoneOffset(), который извлекает разницу (в минутах) между моментом создания объекта now и всемирным временем. Затем смещение временного пояса преобразуется в часы путем деления результата на 60.
var date:Date = new Date(); trace(date.getTimezoneOffset() / 60);
getUTCDate | () | метод |
AS3 function getUTCDate():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date день месяца (целое число от 1 до 31) по всемирному скоординированному времени (UTC).
Number — День месяца в формате UTC (1 – 31), который представляет объект Date.
|
Связанные элементы API
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Затем вызывается метод getUTCDate(), который извлекает число месяца в формате UTC.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getUTCDate()); // 30
getUTCDay | () | метод |
AS3 function getUTCDay():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date день недели (0 – воскресенье, 1 – понедельник и т. д.) по всемирному скоординированному времени (UTC).
Number — День недели в формате UTC (0 – 6), который представляет объект Date.
|
Связанные элементы API
Пример ( Использование этого примера )
weekDayLabels с элементами [Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday] и новый объект Date someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). После этого дважды вызывается метод getUTCDay(), который сначала показывает число месяца в виде цифры 6, а затем показывает день недели с помощью weekDayLabels в формате UTC.
var weekDayLabels:Array = new Array("Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday");
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCDay()); // 6
trace(weekDayLabels[someBirthday.getUTCDay()]); // Saturday
getUTCFullYear | () | метод |
AS3 function getUTCFullYear():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date четырехзначный год по всемирному скоординированному времени (UTC).
Number — Четырехзначный год по всемирному скоординированному времени, который представляется объектом Date.
|
Связанные элементы API
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Затем вызывается метод getUTCFullYear(), который извлекает четырехзначный год в формате UTC.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getUTCFullYear()); // 1974
getUTCHours | () | метод |
AS3 function getUTCHours():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date час дня (целое число от 0 до 23) по всемирному скоординированному времени (UTC).
Number — День недели в формате UTC (от 0 до 23), который представляет объект Date.
|
Связанные элементы API
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Затем вызываются методы getHours() и getMinutes(), которые извлекают часы и минуты в 24-часовом формате. В итоге создается строка localTime, которая присваивается результату вызова функции getUSClockTime(), которая, в свою очередь, снова вызывает методы getHours() и getMinutes(), указывающее время 03:05 PM. Последней создается переменная String utcTime. Метод создания аналогичен методу создания localTime, и в данном случае получается одинаковый результат.
var someBirthday:Date = new Date(1974, 10, 30, 15, 5);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5
var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes());
trace(localTime); // 03:05 PM
var utcTime:String = getUSClockTime(someBirthday.getUTCHours(), someBirthday.getUTCMinutes());
trace(utcTime); // 11:05 PM
function getUSClockTime(hrs:uint, mins:uint):String {
var modifier:String = "PM";
var minLabel:String = doubleDigitFormat(mins);
if(hrs > 12) {
hrs = hrs-12;
} else if(hrs == 0) {
modifier = "AM";
hrs = 12;
} else if(hrs < 12) {
modifier = "AM";
}
return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier);
}
function doubleDigitFormat(num:uint):String {
if(num < 10) {
return ("0" + num);
}
return num;
}
getUTCMilliseconds | () | метод |
AS3 function getUTCMilliseconds():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date число миллисекунд (целое число от 0 до 999) по всемирному скоординированному времени (UTC).
Number — Фрагмент объекта Date с миллисекундами (UTC).
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getUTCMilliseconds(), который извлекает из объекта Date now число миллисекунд на момент создания
var now:Date = new Date(); trace(now.getUTCMilliseconds());
getUTCMinutes | () | метод |
AS3 function getUTCMinutes():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date число минут (целое число от 0 до 59) по всемирному скоординированному времени (UTC).
Number — Фрагмент объекта Date с минутами (UTC).
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getUTCMinutes(), который извлекает из объекта Date now число минут на момент создания
var now:Date = new Date(); trace(now.getUTCMinutes());
getUTCMonth | () | метод |
AS3 function getUTCMonth():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date месяц (от 0 [январь] до 11 [декабрь]) по всемирному скоординированному времени (UTC).
Number — Фрагмент объекта Date с месяцем (UTC).
|
Связанные элементы API
Пример ( Использование этого примера )
monthLabels с элементами от January до December и новый объект Date now без параметров. Затем дважды вызывается метод getUTCMonth(), который сначала возвращает номер месяца, а затем указывает месяц создания объекта Date now.
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(now.getUTCMonth());
trace(monthLabels[now.getUTCMonth()]);
getUTCSeconds | () | метод |
AS3 function getUTCSeconds():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает из объекта Date число секунд (целое число от 0 до 59) по всемирному скоординированному времени (UTC).
Number — Фрагмент объекта Date с секундами (UTC).
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getUTCSeconds(), который извлекает из объекта Date now число минут на момент создания
var now:Date = new Date(); trace(now.getUTCSeconds());
parse | () | метод |
public static function parse(date:String):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Преобразует строку, представляющую дату, в число, равное количеству миллисекунд с полуночи 1 января 1970 года по Гринвичу (UTC).
Параметры
date:String — Строка, представляющая дату, соответствующую выходному формату Date.toString(). Формат выводимой даты Date.toString() выглядит следующим образом:
Day Mon DD HH:MM:SS TZD YYYY
Например:
Wed Apr 12 15:30:17 GMT-0700 2006
Идентификатор временного пояса (TZD) всегда представлен в формате
MM/DD/YYYY HH:MM:SS TZD
HH:MM:SS TZD Day Mon/DD/YYYY
Mon DD YYYY HH:MM:SS TZD
Day Mon DD HH:MM:SS TZD YYYY
Day DD Mon HH:MM:SS TZD YYYY
Mon/DD/YYYY HH:MM:SS TZD
YYYY/MM/DD HH:MM:SS TZD
|
Number — Число, выражающее количество миллисекунд, прошедшее с 1 января 1970 года по всемирному скоординированному времени (UTC).
|
Связанные элементы API
Пример ( Использование этого примера )
dateParsed, который соответствует 30 ноября 1974 г. Затем вызывается метод Date.parse(), преобразующий эту дату в число миллисекунд, прошедших с 1 января 1970 г.
var dateParsed:String = "Sat Nov 30 1974"; var milliseconds:Number = Date.parse(dateParsed); trace(milliseconds); // 155030400000
setDate | () | метод |
AS3 function setDate(day:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает день месяца по местному времени и возвращает новое время в миллисекундах. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Параметры
day:Number — Целое число от 1 до 31.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Затем вызывается метод getDate(), определяющий день месяца. Вызывается метод setDate() с параметром day, которому присваивается значение 20, а затем снова выполняется вызов метода getDate(), определяющего недавно выбранное число месяца.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getDate()); // 30 someBirthday.setDate(20); trace(someBirthday.getDate()); // 20
setFullYear | () | метод |
AS3 function setFullYear(year:Number, month:Number, day:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает год по местному времени и возвращает новое время в миллисекундах. Если указаны параметры month и day, им присваивается местное время. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Вызов этого метода не приводит к изменению других полей объекта Date, но методы Date.getUTCDay() и Date.getDay() могут указывать новое значение, если день недели изменяется в результате вызова этого метода.
Параметры
year:Number — Четырехзначное число, определяющее год. Двухзначные числа не представляют четырехзначные; например, 99 соответствует не 1999, а 99 году.
| |
month:Number — Целое число от 0 (январь) до 11 (декабрь).
| |
day:Number — Число от 1 до 31.
|
Number — Новое время в миллисекундах.
|
Связанные элементы API
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). После этого вызывается метод getFullYear(), который извлекает четырехзначное обозначение года. Затем вызывается метод setFullYear() с параметром year, которому присваивается значение 2000, а затем снова выполняется вызов метода getFullYear(), определяющего недавно выбранный год.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getFullYear()); // 1974 someBirthday.setFullYear(2000); trace(someBirthday.getFullYear()); // 2000
setHours | () | метод |
AS3 function setHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает час по местному времени и возвращает новое время в миллисекундах. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Параметры
hour:Number — Целое число от 0 (полночь) до 23 (11 часов вечера).
| |
minute:Number — Целое число от 0 до 59.
| |
second:Number — Целое число от 0 до 59.
| |
millisecond:Number — Целое число от 0 до 999.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Затем вызываются методы getHours() и getMinutes(), определяющие часы и минуты. После этого выполняется вызов метода setHours() с параметром hour, которому присваивается значение 12, а затем методы getHours() и getMinutes() вызываются снова, определяя только что установленное время в часах и минутах.
var someBirthday:Date = new Date(1974, 10, 30, 15, 20); trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974 trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20 someBirthday.setHours(12); trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 12:20
setMilliseconds | () | метод |
AS3 function setMilliseconds(millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает количество миллисекунд по местному времени и возвращает новое время в миллисекундах. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Параметры
millisecond:Number — Целое число от 0 до 999.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getMilliseconds(), который извлекает значение миллисекунд на момент создания объекта now. Затем снова вызывается новый объект Date before. При этом выполняется дополнительный вызов метода setMilliseconds(), где параметру millisecond присвоено значение 4 и метода getMilliseconds(), извлекающего недавно установленное значение в миллисекундах.
var now:Date = new Date(); trace(now); trace(now.getMilliseconds()); var before:Date = new Date(now.setMilliseconds(4)); trace(before); trace(before.getMilliseconds());
setMinutes | () | метод |
AS3 function setMinutes(minute:Number, second:Number, millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает количество минут по местному времени и возвращает новое время в миллисекундах. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Параметры
minute:Number — Целое число от 0 до 59.
| |
second:Number — Целое число от 0 до 59.
| |
millisecond:Number — Целое число от 0 до 999.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getMinutes(), который извлекает значение миллисекунд на момент создания объекта now. Затем снова вызывается новый объект Date before. При этом выполняется дополнительный вызов метода setMinutes(), где параметру minute присвоено значение 0 и метода getMinutes(), извлекающего недавно установленное значение в минутах.
var now:Date = new Date(); trace(now); trace(now.getMinutes()); var before:Date = new Date(now.setMinutes(0)); trace(before); trace(before.getMinutes());
setMonth | () | метод |
AS3 function setMonth(month:Number, day:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает месяц и (при необходимости) день месяца по местному времени и возвращает новое время в миллисекундах. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Параметры
month:Number — Целое число от 0 (январь) до 11 (декабрь).
| |
day:Number — Целое число от 1 до 31.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
monthLabels с элементами от January до December и новый объект месяца now без параметров. Затем вызывается метод getMonth(), который извлекает значение месяца на момент создания объекта now. Затем вызывается метод setMonth() с параметром month, которому присваивается значение 0, а затем снова выполняется вызов метода getMonth(), определяющего недавно выбранный месяц.
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(monthLabels[now.getMonth()]);
now.setMonth(0);
trace(now.getMonth()); // 0
trace(monthLabels[now.getMonth()]); // January
setSeconds | () | метод |
AS3 function setSeconds(second:Number, millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает количество секунд по местному времени и возвращает новое время в миллисекундах. Местное время определяется операционной системой, в которой запущена среда выполнения Flash.
Параметры
second:Number — Целое число от 0 до 59.
| |
millisecond:Number — Целое число от 0 до 999.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getseconds(), который извлекает значение секунд на момент создания объекта now. Затем вызывается метод setSeconds(), где параметр second принимает значения 0, а после этого снова вызывается метод getSeconds(), определяющий недавно установленное время в секундах.
var now:Date = new Date(); trace(now.getSeconds()); now.setSeconds(0); trace(now.getSeconds()); // 0
setTime | () | метод |
AS3 function setTime(millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает дату в миллисекундах с полуночи 1 января 1970 года и возвращает новое время в миллисекундах.
Параметры
millisecond:Number — Целое число, для которого 0 означает полночь 1 января по универсальному времени (UTC).
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод setTime(), где параметру millisecond присвоено значение -1292601600000, который устанавливает время Tue Jan 15 00:00:00 GMT-0800 1929.
var now:Date = new Date(); trace(now); now.setTime(-1292601600000); trace(now); // Tue Jan 15 00:00:00 GMT-0800 1929
setUTCDate | () | метод |
AS3 function setUTCDate(day:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает день месяца по Гринвичу (UTC) и возвращает новое время в миллисекундах. Вызов этого метода не приводит к изменению других полей объекта Date, но методы Date.getUTCDay() и Date.getDay() могут указывать новое значение, если день недели изменяется в результате вызова этого метода.
Параметры
day:Number — Целое число от 1 до 31.
|
Number — Новое время в миллисекундах.
|
Связанные элементы API
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Вызывается метод getUTCDate(), правильно возвращающий день месяца. Затем вызывается метод setUTCDate(), где параметру day присвоено значение 1, а инструкция trace() подтверждает правильность установки даты.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getUTCDate()); // 30 someBirthday.setUTCDate(1); trace(someBirthday); // Fri Nov 1 01:20:00 GMT-0800 1974
setUTCFullYear | () | метод |
AS3 function setUTCFullYear(year:Number, month:Number, day:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает год по Гринвичу (UTC) и возвращает новое время в миллисекундах.
При желании этот метод может установить также месяц и день месяца. Вызов этого метода не приводит к изменению других полей, но методы Date.getUTCDay() и Date.getDay() могут указывать новое значение, если день недели изменяется в результате вызова этого метода.
Параметры
year:Number — Целое число, которое представляет собой год в полном четырехзначном формате (например, 2000).
| |
month:Number — Целое число от 0 (январь) до 11 (декабрь).
| |
day:Number — Целое число от 1 до 31.
|
Number — Целое число.
|
Связанные элементы API
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Вызывается метод getUTCFullYear(), который правильно возвращает четырехзначный год. Затем вызывается метод setUTCFullYear(), где параметру year присвоено значение 1975, а инструкция trace() подтверждает правильность установки года.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20); trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 trace(someBirthday.getUTCFullYear()); // 1974 someBirthday.setUTCFullYear(1975); trace(someBirthday); // Thu Nov 30 01:20:00 GMT-0800 1975
setUTCHours | () | метод |
AS3 function setUTCHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает час по Гринвичу (UTC) и возвращает новое время в миллисекундах. При желании можно также указать минуты, секунды и миллисекунды.
Параметры
hour:Number — Целое число от 0 (полночь) до 23 (11 часов вечера).
| |
minute:Number — Целое число от 0 до 59.
| |
second:Number — Целое число от 0 до 59.
| |
millisecond:Number — Целое число от 0 до 999.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20). Затем вызываются методы getHours(), getMinutes(), getUTCHours и getUTCMinutes, определяющие часы и минуты. После этого вызывается метод setUTCHours() с параметром hour, для которого выбрано значение 12. И, наконец, повторно вызываются методы getHours(), getMinutes(), getUTCHours() и getUTCMinutes() и правильно показывается обновленное время в часах.
var someBirthday:Date = new Date(1974, 10, 30, 15, 20); trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974 trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20 trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 23:20 someBirthday.setUTCHours(12); trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 4:20 trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 12:20
setUTCMilliseconds | () | метод |
AS3 function setUTCMilliseconds(millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает количество миллисекунд по Гринвичу (UTC) и возвращает новое время в миллисекундах.
Параметры
millisecond:Number — Целое число от 0 до 999.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getUTCMilliseconds(), который извлекает значение миллисекунд (UTC) на момент создания объекта now. Затем снова вызывается новый объект Date before. При этом выполняется дополнительный вызов метода setUTCMilliseconds(), где параметру millisecond присвоено значение 4 и метода getUTCMilliseconds(), извлекающего недавно установленное значение в миллисекундах.
var now:Date = new Date(); trace(now); trace(now.getUTCMilliseconds()); var before:Date = new Date(now.setUTCMilliseconds(4)); trace(before); trace(before.getUTCMilliseconds());
setUTCMinutes | () | метод |
AS3 function setUTCMinutes(minute:Number, second:Number, millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает количество минут по Гринвичу (UTC) и возвращает новое время в миллисекундах. При желании можно указать секунды и миллисекунды.
Параметры
minute:Number — Целое число от 0 до 59.
| |
second:Number — Целое число от 0 до 59.
| |
millisecond:Number — Целое число от 0 до 999.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getUTCMinutes(), который извлекает значение минут (UTC) на момент создания объекта now. Затем снова вызывается новый объект Date before. При этом выполняется дополнительный вызов метода setUTCMinutes(), где параметру minute присвоено значение 0 и метода getUTCMinutes(), извлекающего недавно установленное значение в минутах.
var now:Date = new Date(); trace(now); trace(now.getUTCMinutes()); var before:Date = new Date(now.setUTCMinutes(0)); trace(before); trace(before.getUTCMinutes());
setUTCMonth | () | метод |
AS3 function setUTCMonth(month:Number, day:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает месяц и (при необходимости) день месяца по Гринвичу (UTC) и возвращает новое время в миллисекундах. Вызов этого метода не приводит к изменению других полей, но методы Date.getUTCDay() и Date.getDay() могут указывать новое значение, если день недели изменяется в результате вызова этого метода.
Параметры
month:Number — Целое число от 0 (январь) до 11 (декабрь).
| |
day:Number — Целое число от 1 до 31.
|
Number — Новое время в миллисекундах.
|
Связанные элементы API
Пример ( Использование этого примера )
UTCMonthLabels с элементами от January до December и новый объект UTCMonth now без параметров. Затем вызывается метод getUTCMonth(), который извлекает значение месяца (UTC) на момент создания объекта now. После этого вызывается метод setUTCMonth() с параметром month, которому присваивается значение 0, а затем снова выполняется вызов метода getUTCMonth(), определяющего недавно выбранный месяц.
var UTCMonthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getUTCMonth());
trace(UTCMonthLabels[now.getUTCMonth()]);
now.setUTCUTCMonth(0);
trace(now.getUTCMonth()); // 0
trace(UTCMonthLabels[now.getUTCMonth()]); // January
setUTCSeconds | () | метод |
AS3 function setUTCSeconds(second:Number, millisecond:Number):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Задает количество секунд и (при необходимости) миллисекунд по Гринвичу (UTC) и возвращает новое время в миллисекундах.
Параметры
second:Number — Целое число от 0 до 59.
| |
millisecond:Number — Целое число от 0 до 999.
|
Number — Новое время в миллисекундах.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getUTCSeconds(), который извлекает значение секунд на момент создания объекта now. После этого вызывается метод setUTCSeconds(), где параметр second принимает значение 0, а потом снова вызывается метод getUTCSeconds(), определяющий недавно установленное время в секундах.
var now:Date = new Date(); trace(now.getUTCSeconds()); now.setUTCSeconds(0); trace(now.getUTCSeconds()); // 0
toDateString | () | метод |
AS3 function toDateString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает строковое представление дня и даты без времени или часового пояса. Сравните это с указанными ниже методами.
Date.toTimeString(), который возвращает только время и часовой пояс.Date.toString(), который возвращает не только день и дату, но также время и часовой пояс.
String — Строковое представление дня и даты.
|
Связанные элементы API
Пример ( Использование этого примера )
now без параметров, а затем вызываются следующие методы в операторе trace().
toString: показывает все параметрыnowна момент создания объектаnow.toDateString(): показывает значения параметровday,monthиyearна момент создания объектаnow.
var now:Date = new Date(); trace(now); trace(now.toDateString());
toJSON | () | метод |
AS3 function toJSON(k:String):*| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 11, AIR 3, Flash Lite 4 |
Предоставляет переопределяемый метод, позволяющий настраивать кодировку JSON значений в объекте Date.
Метод JSON.stringify() ищет метод toJSON() в каждом объекте, который он проходит. В случае обнаружения toJSON() метод JSON.stringify() вызывает его для каждого обнаруженного значения, передавая ключ, составляющий пару с этим значением.
Объект Date обеспечивает реализацию toJSON() по умолчанию, которая возвращает вывод метода Date.toString(). Если требуется экспортировать объекты Date в JSON в любом другом формате, можно настроить собственную реализацию. Для этого необходимо переопределить метод toJSON() в прототипе класса.
Метод toJSON() может возвращать значение любого типа. Если он возвращает объект, stringify() возвращается к этому объекту. Если toJSON() возвращает строку, stringify() не возвращается и продолжает прохождение.
Параметры
k:String — Ключ из пары «ключ/значение», обнаруженный методом JSON.stringify() при прохождении этого объекта
|
* — Значение Date.toString() объекта.
|
Связанные элементы API
Object.prototype
toLocaleDateString | () | метод |
AS3 function toLocaleDateString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает строковое представление дня и даты без времени или часового пояса. Этот метод возвращает то же значение, что и Date.toDateString. Сравните это с указанными ниже методами.
Date.toTimeString(), который возвращает только время и часовой пояс.Date.toString(), который возвращает не только день и дату, но также время и часовой пояс.
String — Представление дня и даты типа String.
|
Связанные элементы API
toLocaleString | () | метод |
AS3 function toLocaleString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает строковое представление дня, даты и времени по местному времени. Сравните это с методом Date.toString(), возвращающим ту же информацию (а также часовой пояс), относящуюся к году, указанному в конце строки.
String — Строковое представление объекта Date в местном часовом поясе.
|
toLocaleTimeString | () | метод |
AS3 function toLocaleTimeString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает строковое представление времени без дня, даты, года или часового пояса. Сравните это с методом Date.toTimeString(), который возвращает время и часовой пояс.
String — Строковое представление времени и часового пояса.
|
Связанные элементы API
toString | () | метод |
AS3 function toString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает строковое представление дня, даты, времени и часового пояса. Формат выводимой даты:
Day Mon Date HH:MM:SS TZD YYYY
Например:
Wed Apr 12 15:30:17 GMT-0700 2006
ВозвращаетString — Строковое представление объекта Date.
|
Пример ( Использование этого примера )
now без параметров, а затем вызывается метод toString в инструкции trace(), который показывает параметры объекта now на момент создания now.
var now:Date = new Date(); trace(now);
toTimeString | () | метод |
AS3 function toTimeString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает строковое представление времени и часового пояса без дня и даты. Сравните это с методом Date.toDateString(), который возвращает только день и дату.
String — Строковое представление времени и часового пояса.
|
Связанные элементы API
toUTCString | () | метод |
AS3 function toUTCString():String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает строковое представление дня, даты и времени по Гринвичу (UTC). Например, дата 1 февраля 2005 г. выглядит как Tue Feb 1 00:00:00 2005 UTC.
String — Строковое представление объекта Date по всемирному скоординированному времени.
|
Связанные элементы API
UTC | () | метод |
public static function UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает число миллисекунд от полуночи 1 января 1970 года по Гринвичу до момента, заданного параметрами. В этом методе используется всемирное скоординированное время, а в конструкторе Date – местное время.
Этот метод полезен, если требуется передать дату в формате всемирного скоординированного времени (UTC) конструктору класса Date. Поскольку конструктор класса данных Date поддерживает в качестве аргумента смещение в миллисекундах, можно воспользоваться методом Date.UTC(), чтобы преобразовать дату в формате UTC в соответствующее смещение, выраженное в миллисекундах, а затем отправить это смещение в качестве аргумента конструктору класса Date:
Параметры
year:Number — Целое четырехзначное число, указывающее на год (например, 2000).
| |
month:Number — Целое число от 0 (январь) до 11 (декабрь).
| |
date:Number (default = 1) | |
hour:Number (default = 0) | |
minute:Number (default = 0) | |
second:Number (default = 0) | |
millisecond:Number (default = 0) |
Number — Количество миллисекунд, прошедших с 1 января 1970 г. до указанных даты и времени.
|
Пример ( Использование этого примера )
someBirthday с параметрами year (1974), month (10 = ноябрь), day (30), hour (1) и minute (20) по местному времени. Затем выполняется вызов UTC() в методе setTime(), который приводит к сбросу значений этих параметров и установке всемирного времени.
var someBirthday:Date = new Date(1974, 10, 30, 15, 20); trace(someBirthday.toString()); someBirthday.setTime(Date.UTC(1974, 10, 30, 15, 20)); trace(someBirthday.toString());
valueOf | () | метод |
AS3 function valueOf():Number| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Возвращает для объекта Date число миллисекунд с полуночи 1 января 1970 года по всемирному скоординированному времени.
Number — Количество миллисекунд с 1 января 1970 г., выражаемое объектом Date.
|
Пример ( Использование этого примера )
now без параметров. Затем вызывается метод getTime(), который определяет количество миллисекунд между временем создания now и полуночью 1 января 1970 г. После этого вызывается метод valueOf(), определяющий то же самое.
var now:Date = new Date(); trace(now.getTime()); trace(now.valueOf());
Date(), присваивающего следующие переменные:
myDate1вызывает конструкторDate()без параметров. При этом дляmyDate1выбираются текущие дата и время (исходя из текущих системных даты и времени).myDate2вызывает конструкторDate(), для которого выбраны параметрыyear(2000), month (0= январь) иday(1).myDate3вызывает конструкторDate(), для которого выбраны параметрыyear(65= 1965),month(2= март),day(6),hour(9),minute(30),second(15) иmillisecond-+ (0).myDate4вызывает конструкторDate(), временное значение которого отражает количество миллисекунд до 0:00:00 1 января 1970 г. (среднее время по Гринвичу), поскольку это отрицательное значение.
package {
import flash.display.Sprite;
public class DateExample extends Sprite{
public function DateExample() {
var myDate1:Date = new Date();
trace(myDate1); // [NOW]
var myDate2:Date = new Date(2000, 0, 1);
trace(myDate2); // Sat Jan 1 00:00:00 GMT-0800 2000
var myDate3:Date = new Date(65, 2, 6, 9, 30, 15, 0);
trace(myDate3); // Sat Mar 6 09:30:15 GMT-0800 1965
var myDate4:Date = new Date(-14159025000);
trace(myDate4); // Sun Jul 20 19:56:15 GMT-0700 1969
}
}
}
Tue Jun 12 2018, 11:34 AM Z