| Pacote | Nível superior |
| Classe | public final dynamic class Date |
| Herança | Date  Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Date.UTC() e Date.parse() são exceções; eles são métodos estáticos.
A classe Date manipula o horário de verão de maneira diferente, dependendo do sistema operacional e da versão do tempo de execução. O Flash Player 6 e versões posteriores manipulam o horário de verão nos sistemas operacionais a seguir, destas maneiras:
- Windows - o objeto Date ajusta automaticamente sua saída para o horário de verão. O objeto Date detecta se o horário de verão é empregado na localidade atual e, em caso positivo, detecta a data e as horas de transição de padrão para horário de verão. Entretanto, as datas de transição atualmente em vigor são aplicadas às datas no passado e no futuro, de modo que a mudança para o horário de verão pode ser calculada incorretamente para datas no passado quando a localidade possuía datas de transição diferentes.
- Mac OS X - o objeto Date ajusta automaticamente sua saída para o horário de verão. O banco de dados de informações de fuso horário no Mac OS X é usado para determinar se deve ser aplicada a mudança para horário de verão para qualquer data ou hora no presente ou no passado.
- Mac OS 9 - o sistema operacional fornece apenas informações suficientes para determinar se deve ser aplicada a mudança para horário de verão, para a data e hora atuais. De acordo, o objeto Date pressupõe que a tendência atual de horário de verão se aplica a todas as datas e horas no passado ou futuro.
O Flash Player 5 manipula o horário de verão desta maneira nos sistemas operacionais a seguir:
- Windows - as regras norte-americanas para o horário de verão são sempre aplicadas, o que resulta em transições incorretas na Europa e em outras áreas que utilizam o horário de verão, mas que possuem horários de transição diferentes dos EUA. O Flash detecta corretamente se o horário de verão é usado na localidade atual.
Para usar a classe Date, construa uma ocorrência de Data usando o operador new.
O ActionScript 3.0 adiciona várias novas propriedades de acesso que podem ser usadas no lugar de vários métodos da classe Date que acessam ou modificam ocorrências de Date. O ActionScript 3.0 também incluiu várias novas variações do método toString() que são inclusas para conformidade com a terceira edição do ECMA-262, incluindo: Date.toLocaleString(), Date.toTimeString(), Date.toLocaleTimeString(), Date.toDateString(), e Date.toLocaleDateString().
Para calcular o tempo relativo ou o tempo decorrido, consulte o método getTimer() no pacote flash.utils.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| date : Number
O dia do mês (um inteiro de 1 a 31) especificado por um objeto Date de acordo com o horário local. | Date | ||
| dateUTC : Number
O dia do mês (um inteiro de 1 a 31) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
| day : Number [somente leitura]
O dia da semana (0 para domingo, 1 para segunda-feira e assim por diante) especificado por essa Data de acordo com o horário local. | Date | ||
| dayUTC : Number [somente leitura]
O dia da semana (0 para domingo, 1 para segunda-feira e assim por diante) dessa Data de acordo com o horário universal (UTC). | Date | ||
| fullYear : Number
O ano completo (um número de quatro dígitos, como 2000) de um objeto Date de acordo com o horário local. | Date | ||
| fullYearUTC : Number
O ano de quatro dígitos de um objeto Date de acordo com o horário universal (UTC). | Date | ||
| hours : Number
A hora (um inteiro de 0 a 23) da parte do dia de um objeto Date de acordo com o horário local. | Date | ||
| hoursUTC : Number
A hora (um inteiro de 0 a 23) do dia de um objeto Date de acordo com o horário universal (UTC). | Date | ||
| milliseconds : Number
A parte dos milésimos de segundo (um inteiro de 0 a 999) de um objeto Date de acordo com o horário local. | Date | ||
| millisecondsUTC : Number
A parte dos milésimos de segundo (um inteiro de 0 a 999) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
| minutes : Number
A parte dos minutos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário local. | Date | ||
| minutesUTC : Number
A parte dos minutos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
| month : Number
O mês (0 para janeiro, 1 para fevereiro e assim por diante) de um objeto Date de acordo com o horário local. | Date | ||
| monthUTC : Number
A parte do mês (0 [janeiro] a 11 [dezembro]) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
| seconds : Number
A parte dos segundos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário local. | Date | ||
| secondsUTC : Number
A parte dos segundos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
| time : Number
O número de milésimos de segundo desde a meia-noite de 1° de janeiro de 1970, horário universal, para um objeto Date. | Date | ||
| timezoneOffset : Number [somente leitura]
A diferença, em minutos, entre o horário universal (UTC) e o horário local do computador. | Date | ||
| Método | Definido por | ||
|---|---|---|---|
Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)
Constrói um novo objeto Date que contém a data e a hora especificadas. | Date | ||
Retorna o dia do mês (um inteiro de 1 a 31) especificado por um objeto Date de acordo com o horário local. | Date | ||
Retorna o dia da semana (0 para domingo, 1 para segunda-feira e assim por diante) especificado por essa Data de acordo com o horário local. | Date | ||
Retorna o ano completo (um número de quatro dígitos, como 2000) de um objeto Date de acordo com o horário local. | Date | ||
Retorna a hora (um inteiro de 0 a 23) da parte do dia de um objeto Date de acordo com o horário local. | Date | ||
Retorna a parte dos milésimos de segundo (um inteiro de 0 a 999) de um objeto Date de acordo com o horário local. | Date | ||
Retorna a parte dos minutos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário local. | Date | ||
Retorna a parte do mês (0 para janeiro, 1 para fevereiro e assim por diante) dessa Data de acordo com o horário local. | Date | ||
Retorna a parte dos segundos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário local. | Date | ||
Retorna o número de milésimos de segundo desde a meia-noite de 1° de janeiro de 1970, horário universal, para um objeto Date. | Date | ||
Retorna a diferença, em minutos, entre o horário universal (UTC) e o horário local do computador. | Date | ||
Retorna o dia do mês (um inteiro de 1 a 31) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
Retorna o dia da semana (0 para domingo, 1 para segunda-feira e assim por diante) dessa Data de acordo com o horário universal (UTC). | Date | ||
Retorna o ano de quatro dígitos de um objeto Date de acordo com o horário universal (UTC). | Date | ||
Retorna a hora (um inteiro de 0 a 23) do dia de um objeto Date de acordo com o horário universal (UTC). | Date | ||
Retorna a parte dos milésimos de segundo (um inteiro de 0 a 999) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
Retorna a parte dos minutos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
Retorna a parte do mês (0 [January] a 11 [December]) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
Retorna a parte dos segundos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário universal (UTC). | Date | ||
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
[estático]
Converte uma string que representa uma data em um número que equivale ao número de milésimos de segundo decorridos desde 1° de janeiro de 1970, UTC. | Date | ||
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
Define o dia do mês, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. | Date | ||
Define o ano, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. | Date | ||
Define a hora, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. | Date | ||
Define os milésimos de segundo, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. | Date | ||
Define os minutos, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. | Date | ||
Define o mês e, opcionalmente, o dia do mês, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. | Date | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
Define os segundos, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. | Date | ||
Define a data em milésimos de segundo, desde a meia-noite de 1° de janeiro de 1970, e retorna o novo horário em milésimos de segundo. | Date | ||
Define o dia do mês, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. | Date | ||
Define o ano, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. | Date | ||
Define a hora, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. | Date | ||
Define os milésimos de segundo, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. | Date | ||
Define os minutos, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. | Date | ||
Define o mês e, opcionalmente, o dia, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. | Date | ||
Define os segundos e, opcionalmente, os milésimos de segundo, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. | Date | ||
Retorna uma representação de string do dia e da data apenas e não inclui o horário ou o fuso horário. | Date | ||
Fornece um método que pode ser substituído para personalizar a codificação JSON de valores em um objeto Date. | Date | ||
Retorna uma representação de String do dia e da data apenas e não inclui o horário ou o fuso horário. | Date | ||
Retorna uma representação de String do dia, da data e do horário, fornecida no horário local. | Date | ||
Retorna uma representação de String do horário apenas e não inclui o dia, a data, o ano ou o fuso horário. | Date | ||
Retorna uma representação de String do dia, da data, do horário e do fuso horário. | Date | ||
Retorna uma representação de String do horário e do fuso horário apenas e não inclui o dia e a data. | Date | ||
Retorna uma representação de String do dia, da data e do horário no horário universal (UTC). | Date | ||
UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number [estático]
Retorna o número de milésimos de segundo entre a meia-noite de 1° de janeiro de 1970, horário universal, e o horário especificado nos parâmetros. | Date | ||
Retorna o número de milésimos de segundo desde a meia-noite de 1° de janeiro de 1970, horário universal, para um objeto Date. | Date | ||
date | propriedade |
date:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
O dia do mês (um inteiro de 1 a 31) especificado por um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Implementação
AS3 function get date():Number AS3 function set date(value:Number):voidElementos da API relacionados
dateUTC | propriedade |
dateUTC:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
O dia do mês (um inteiro de 1 a 31) de um objeto Date de acordo com o horário universal (UTC).
Implementação
AS3 function get dateUTC():Number AS3 function set dateUTC(value:Number):voidElementos da API relacionados
day | propriedade |
day:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
O dia da semana (0 para domingo, 1 para segunda-feira e assim por diante) especificado por essa Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Implementação
AS3 function get day():NumberElementos da API relacionados
dayUTC | propriedade |
dayUTC:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
O dia da semana (0 para domingo, 1 para segunda-feira e assim por diante) dessa Date de acordo com o horário universal (UTC).
Implementação
AS3 function get dayUTC():NumberElementos da API relacionados
fullYear | propriedade |
fullYear:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
O ano completo (um número de quatro dígitos, como 2000) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Implementação
AS3 function get fullYear():Number AS3 function set fullYear(value:Number):voidElementos da API relacionados
fullYearUTC | propriedade |
fullYearUTC:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
O ano de quatro dígitos de um objeto Date de acordo com o horário universal (UTC).
Implementação
AS3 function get fullYearUTC():Number AS3 function set fullYearUTC(value:Number):voidElementos da API relacionados
hours | propriedade |
hours:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A hora (um inteiro de 0 a 23) da parte do dia de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Implementação
AS3 function get hours():Number AS3 function set hours(value:Number):voidElementos da API relacionados
hoursUTC | propriedade |
hoursUTC:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A hora (um inteiro de 0 a 23) do dia de um objeto Date de acordo com o horário universal (UTC).
Implementação
AS3 function get hoursUTC():Number AS3 function set hoursUTC(value:Number):voidElementos da API relacionados
milliseconds | propriedade |
milliseconds:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A parte dos milésimos de segundo (um inteiro de 0 a 999) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Implementação
AS3 function get milliseconds():Number AS3 function set milliseconds(value:Number):voidElementos da API relacionados
millisecondsUTC | propriedade |
millisecondsUTC:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A parte dos milésimos de segundo (um inteiro de 0 a 999) de um objeto Date de acordo com o horário universal (UTC).
Implementação
AS3 function get millisecondsUTC():Number AS3 function set millisecondsUTC(value:Number):voidElementos da API relacionados
minutes | propriedade |
minutes:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A parte dos minutos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Implementação
AS3 function get minutes():Number AS3 function set minutes(value:Number):voidElementos da API relacionados
minutesUTC | propriedade |
minutesUTC:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A parte dos minutos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário universal (UTC).
Implementação
AS3 function get minutesUTC():Number AS3 function set minutesUTC(value:Number):voidElementos da API relacionados
month | propriedade |
month:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
O mês (0 para janeiro, 1 para fevereiro e assim por diante) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Implementação
AS3 function get month():Number AS3 function set month(value:Number):voidElementos da API relacionados
monthUTC | propriedade |
monthUTC:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A parte do mês (0 [janeiro] a 11 [dezembro]) de um objeto Date de acordo com o horário universal (UTC).
Implementação
AS3 function get monthUTC():Number AS3 function set monthUTC(value:Number):voidElementos da API relacionados
seconds | propriedade |
seconds:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A parte dos segundos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Implementação
AS3 function get seconds():Number AS3 function set seconds(value:Number):voidElementos da API relacionados
secondsUTC | propriedade |
secondsUTC:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A parte dos segundos(um inteiro de 0 a 59) de um objeto Date de acordo com o horário universal (UTC).
Implementação
AS3 function get secondsUTC():Number AS3 function set secondsUTC(value:Number):voidElementos da API relacionados
time | propriedade |
time:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
O número de milésimos de segundo desde a meia-noite de 1° de janeiro de 1970, horário universal, para um objeto Date. Use esse método para representar um instante específico no tempo ao comparar dois ou mais objetos Date.
Implementação
AS3 function get time():Number AS3 function set time(value:Number):voidElementos da API relacionados
timezoneOffset | propriedade |
timezoneOffset:Number [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
A diferença, em minutos, entre o horário universal (UTC) e o horário local do computador. Especificamente, esse valor é o número de minutos que você precisa adicionar ao horário local do computador para equivaler ao UTC. Se o horário do computador estiver definido como posterior ao UTC, o valor será negativo.
Implementação
AS3 function get timezoneOffset():NumberElementos da API relacionados
Date | () | Construtor |
public function Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Constrói um novo objeto Date que contém a data e a hora especificadas.
O construtor Date() utiliza até sete parâmetros (ano, mês, ..., milésimo de segundo) para especificar uma data e uma hora até milésimos de segundo. A data que o objeto Date recém-construído contém depende do número, e do tipo de dados, de argumentos transmitidos.
- Se você não transmitir argumentos, o objeto Date será atribuído à data e à hora atuais.
- Se você transmitir um argumento do tipo de dados Number, o objeto Date será atribuído a um valor de hora com base no número de milésimos de segundo desde 1° de janeiro de 1970, 0:00:000 GMT, conforme especificado pelo argumento isolado.
- Se você transmitir um argumento do tipo de dados String e a string contiver uma data válida, o objeto Date conterá um valor de tempo com base nessa data.
- Se você transmitir dois ou mais argumentos, o objeto Date será atribuído a um valor de hora com base nos valores dos argumentos transmitidos, que representam o ano, o mês, a data, a hora, o minuto, o segundo e os milésimos de segundo da data.
Se você transmitir uma string ao construtor da classe Date, a data poderá estar em vários formatos, mas deverá incluir pelo menos o mês, a data e o ano. Por exemplo, Feb 1 2005 é válido, mas Feb 2005 não é. A lista a seguir indica alguns dos formatos válidos:
- Dia Mês Data Horas:Minutos:Segundos GMT Ano (por exemplo, "Terça-feira, 1° de fevereiro 00:00:00 GMT-0800 2005", que corresponde a
toString()) - Dia Mês Data Ano Horas:Minutos:Segundos AM/PM (por exemplo, "Terça-feira, 1° de fevereiro de 2005 12:00:00 AM", que corresponde a
toLocaleString()) - Dia Mês Data Ano (por exemplo, "Terça-feira, 1° de fevereiro de 2005", que corresponde a
toDateString()) - Mês/Dia/Ano (por exemplo, "02/01/2005")
- Mês/Ano (por exemplo, "02/2005")
yearOrTimevalue:Object — Se outros parâmetros forem especificados, esse número representará um ano (como 1965); caso contrário, representará um valor de hora. Se o número representar um ano, um valor de 0 a 99 indicará de 1900 a 1999; caso contrário, todos os quatro dígitos do ano deverão ser especificados. Se o número representar um valor de hora (nenhum outro parâmetro for especificado), ele será o número de milésimos de segundo antes ou depois de 0:00:00 GMT de 1° de janeiro de 1970; um valor negativo representa um tempo antes de 0:00:00 GMT de 1° de janeiro de 1970, enquanto um valor positivo representa um horário após.
| |
month:Number — Um inteiro de 0 (janeiro) a 11 (dezembro).
| |
date:Number (default = 1) | |
hour:Number (default = 0) | |
minute:Number (default = 0) | |
second:Number (default = 0) | |
millisecond:Number (default = 0) |
Elementos da API relacionados
getDate | () | método |
AS3 function getDate():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o dia do mês (um inteiro de 1 a 31) especificado por um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Number — O dia do mês (1 - 31) que um objeto Date representa.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getDate() é então chamado, recuperando o dia do mês.
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 | () | método |
AS3 function getDay():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o dia da semana (0 para domingo, 1 para segunda-feira e assim por diante) especificado por essa Data de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Number — Uma versão numérica do dia da semana (0 a 6) que um objeto Date representa.
|
Exemplo ( Como usar este exemplo )
weekDayLabels com os elementos [domingo,segunda,terça,quarta,quinta,sexta,sábado] e um novo objeto Date someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getDay() é então chamado duas vezes, mostrando primeiro o dia do mês como 6 e, em seguida, mostrando o dia da semana com o uso de 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 | () | método |
AS3 function getFullYear():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o ano completo (um número de quatro dígitos, como 2000) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Number — O ano completo que um objeto Date representa.
|
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getFullYear() é então chamado, recuperando o ano de quatro dígitos.
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 | () | método |
AS3 function getHours():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a hora (um inteiro de 0 a 23) da parte do dia de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Number — A hora (0 a 23) do dia que um objeto Date representa.
|
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). Os métodos getHours() e getMinutes() são então chamados, recuperando as horas e os minutos no formato de 24 horas. Por fim, uma string localTime é criada e atribuída ao resultado de uma chamada à função getUSClockTime(), que, por sua vez, chama getHours() e getMinutes() novamente, resultando no horário 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 | () | método |
AS3 function getMilliseconds():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a parte dos milésimos de segundo (um inteiro de 0 a 999) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Number — A parte dos milésimos de segundo de um objeto Date.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getMilliseconds() é então chamado, recuperando os milésimos de segundo do objeto Date now na ocasião em que ele foi criado.
var now:Date = new Date(); trace(now.getMilliseconds());
getMinutes | () | método |
AS3 function getMinutes():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a parte dos minutos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Number — A parte dos minutos de um objeto Date.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getMinutes() é então chamado, recuperando os minutos do objeto Date now na ocasião em que ele foi criado.
var now:Date = new Date(); trace(now); trace(now.getMinutes());
getMonth | () | método |
AS3 function getMonth():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a parte do mês (0 para janeiro, 1 para fevereiro e assim por diante) dessa Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Number — A parte do mês (0 a 11) de um objeto Date.
|
Exemplo ( Como usar este exemplo )
monthLabels com os elementos January a December e um novo objeto Date now sem parâmetros. O método getMonth() é então chamado duas vezes, retornando primeiro o número do mês e, em seguida, o nome do mês referente ao mês em que o objeto Date now foi criado.
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 | () | método |
AS3 function getSeconds():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a parte dos segundos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Number — A parte dos segundos (0 a 59) de um objeto Date.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getSeconds() é então chamado, recuperando os segundos do objeto Date now na ocasião em que ele foi criado.
var now:Date = new Date(); trace(now.getSeconds());
getTime | () | método |
AS3 function getTime():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o número de milésimos de segundo desde a meia-noite de 1° de janeiro de 1970, horário universal, para um objeto Date. Use esse método para representar um instante específico no tempo ao comparar dois ou mais objetos Date.
Number — O número de milésimos de segundo desde 1° de janeiro de 1970 que um objeto Date representa.
|
Exemplo ( Como usar este exemplo )
mlk com os parâmetros year (1929), month (0 = janeiro) e day (15). O método getTime() é então chamado, recuperando os milésimos de segundo desde a meia-noite de 1° de janeiro de 1970, que é negativo porque o ano está definido como 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 sem parâmetros e, em seguida, usa os seguintes métodos da classe DateMath (criada a seguir) para adicionar tempo ao objeto Date now original desde o momento em que ele foi criado:
addSeconds(): adiciona 30 segundos anow.addMinutes(): adiciona 30 segundos anow.addHours(): adiciona 6 horas ao objeto Datenow.addDays(): adiciona 30 dias ao objeto Datenow.addWeeks(): adiciona 4 semanas anow.
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 | () | método |
AS3 function getTimezoneOffset():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a diferença, em minutos, entre o horário universal (UTC) e o horário local do computador.
RetornaNumber — Os minutos que você precisa adicionar ao valor de horário local do computador para equivaler ao UTC. Se o horário do computador estiver definido como posterior ao UTC, o valor de retorno será negativo.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getTimezoneOffset() é então chamado, recuperando a diferença (em minutos) do horário em que now foi criado e do Horário universal. O deslocamento de fuso horário é convertido em horas dividindo-se o resultado por 60.
var date:Date = new Date(); trace(date.getTimezoneOffset() / 60);
getUTCDate | () | método |
AS3 function getUTCDate():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o dia do mês (um inteiro de 1 a 31) de um objeto Date de acordo com o horário universal (UTC).
Number — O dia UTC do mês (1 a 31) que um objeto Date representa.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getUTCDate() é então chamado, recuperando o dia do mês, de acordo com o 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 | () | método |
AS3 function getUTCDay():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o dia da semana (0 para domingo, 1 para segunda-feira e assim por diante) dessa Date de acordo com o horário universal (UTC).
Number — O dia UTC da semana (0 a 6) que um objeto Date representa.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
weekDayLabels com os elementos [domingo,segunda,terça,quarta,quinta,sexta,sábado] e um novo objeto Date someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getUTCDay() é então chamado duas vezes, mostrando primeiro o dia do mês como 6 e, em seguida, mostrando o dia da semana com o uso de weekDayLabels de acordo com o 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 | () | método |
AS3 function getUTCFullYear():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o ano de quatro dígitos de um objeto Date de acordo com o horário universal (UTC).
Number — O ano UTC de quatro dígitos que um objeto Date representa.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getUTCFullYear() é então chamado, recuperando o ano de quatro dígitos, de acordo com o 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 | () | método |
AS3 function getUTCHours():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a hora (um inteiro de 0 a 23) do dia de um objeto Date de acordo com o horário universal (UTC).
Number — A hora UTC do dia (0 a 23) que um objeto Date representa.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). Os métodos getHours() e getMinutes() são então chamados, recuperando as horas e os minutos no formato de 24 horas. Por fim, uma string localTime é criada e atribuída ao resultado de uma chamada à função getUSClockTime(), que, por sua vez, chama getHours() e getMinutes() novamente, resultando no horário 03:05 PM. Por fim, uma variável de String utcTime é criada da mesma maneira que localTime e, nesse caso, o resultado é o mesmo.
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 | () | método |
AS3 function getUTCMilliseconds():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a parte dos milésimos de segundo (um inteiro de 0 a 999) de um objeto Date de acordo com o horário universal (UTC).
Number — A parte dos milésimos de segundo UTC de um objeto Date.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getUTCMilliseconds() é então chamado, recuperando os milésimos de segundo do objeto Date now na ocasião em que ele foi criado, de acordo com o UTC.
var now:Date = new Date(); trace(now.getUTCMilliseconds());
getUTCMinutes | () | método |
AS3 function getUTCMinutes():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a parte dos minutos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário universal (UTC).
Number — A parte dos minutos UTC de um objeto Date.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getUTCMinutes() é então chamado, recuperando os minutos do objeto Date now na ocasião em que ele foi criado, de acordo com o UTC.
var now:Date = new Date(); trace(now.getUTCMinutes());
getUTCMonth | () | método |
AS3 function getUTCMonth():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a parte do mês (0 [janeiro] a 11 [dezembro]) de um objeto Date de acordo com o horário universal (UTC).
Number — A parte do mês UTC de um objeto Date.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
monthLabels com os elementos January a December e um novo objeto Date now sem parâmetros. O método getUTCMonth() é então chamado duas vezes, retornando primeiro o número do mês e, em seguida, o nome do mês referente ao mês em que o objeto Date now foi criado, de acordo com o UTC.
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 | () | método |
AS3 function getUTCSeconds():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna a parte dos segundos (um inteiro de 0 a 59) de um objeto Date de acordo com o horário universal (UTC).
Number — A parte dos segundos UTC de um objeto Date.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getUTCSeconds() é então chamado, recuperando os segundos do objeto Date now na ocasião em que ele foi criado, de acordo com o UTC.
var now:Date = new Date(); trace(now.getUTCSeconds());
parse | () | método |
public static function parse(date:String):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Converte uma string que representa uma data em um número que equivale ao número de milésimos de segundo decorridos desde 1° de janeiro de 1970, UTC.
Parâmetros
date:String — Uma representação de string de uma data, que está em conformidade com o formato da saída de Date.toString(). O formato de data para a saída de Date.toString() é:
Day Mon DD HH:MM:SS TZD YYYY
Por exemplo:
Wed Apr 12 15:30:17 GMT-0700 2006
A TZD (Designação de fuso horário) está sempre no formato
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 — Um número que representa os milésimos de segundo decorridos desde 1° de janeiro de 1970, UTC.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
dateParsed para 30 de novembro de 1974. O método Date.parse() é então chamado, convertendo a data em milésimos de segundo desde 1° de janeiro de 1970.
var dateParsed:String = "Sat Nov 30 1974"; var milliseconds:Number = Date.parse(dateParsed); trace(milliseconds); // 155030400000
setDate | () | método |
AS3 function setDate(day:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define o dia do mês, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Parâmetros
day:Number — Um inteiro de 1 a 31.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getDate() é então chamado, recuperando o dia do mês. Em seguida, setDate() é chamado com o parâmetro day definido como 20 e, depois, getDate() é chamado novamente, recuperando o dia do mês recém-definido.
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 | () | método |
AS3 function setFullYear(year:Number, month:Number, day:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define o ano, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. Se os parâmetros month e day forem especificados, eles serão definidos como o horário local. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Chamar esse método não modifica os outros campos de Date, mas Date.getUTCDay() e Date.getDay() poderão reportar um novo valor se o dia da semana for alterado como resultado da chamada desse método.
Parâmetros
year:Number — Um número de quatro dígitos que especifica um ano. Números de dois dígitos não representam anos de quatro dígitos; por exemplo, 99 não é o ano 1999, mas sim o ano 99.
| |
month:Number — Um inteiro de 0 (janeiro) a 11 (dezembro).
| |
day:Number — Um número de 1 a 31.
|
Number — O novo horário, em milésimos de segundo.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getFullYear() é então chamado, recuperando o ano de quatro dígitos. Em seguida, setFullYear() é chamado com o parâmetro year definido como 2000 e, depois, getFullYear() é chamado novamente, recuperando o ano recém-definido.
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 | () | método |
AS3 function setHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define a hora, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Parâmetros
hour:Number — Um inteiro de 0 (meia-noite) a 23 (11 p.m.).
| |
minute:Number — Um inteiro de 0 a 59.
| |
second:Number — Um inteiro de 0 a 59.
| |
millisecond:Number — Um inteiro de 0 a 999.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). Os métodos getHours() e getMinutes() são então chamados, recuperando as horas e os minutos. Em seguida, setHours() é chamado com o parâmetro hour definido como 12 e, depois, getHours() e getMinutes() são chamados novamente, recuperando as horas e os minutos recém-definidos.
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 | () | método |
AS3 function setMilliseconds(millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define os milésimos de segundo, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Parâmetros
millisecond:Number — Um inteiro de 0 a 999.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getMilliseconds() é então chamado, recuperando os milésimos de segundo quando now foi criado. Em seguida, outro objeto Date before com uma chamada adicional a setMilliseconds() com o parâmetro millisecond definido como 4 e getMilliseconds() é chamado novamente, recuperando os milésimos de segundo recém-definidos.
var now:Date = new Date(); trace(now); trace(now.getMilliseconds()); var before:Date = new Date(now.setMilliseconds(4)); trace(before); trace(before.getMilliseconds());
setMinutes | () | método |
AS3 function setMinutes(minute:Number, second:Number, millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define os minutos, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Parâmetros
minute:Number — Um inteiro de 0 a 59.
| |
second:Number — Um inteiro de 0 a 59.
| |
millisecond:Number — Um inteiro de 0 a 999.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getMinutes() é então chamado, recuperando os minutos quando now foi criado. Em seguida, outro objeto Date before com uma chamada adicional a setMinutes() com o parâmetro minute definido como 0 e getMinutes() é chamado novamente, recuperando os minutos recém-definidos.
var now:Date = new Date(); trace(now); trace(now.getMinutes()); var before:Date = new Date(now.setMinutes(0)); trace(before); trace(before.getMinutes());
setMonth | () | método |
AS3 function setMonth(month:Number, day:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define o mês e, opcionalmente, o dia do mês, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Parâmetros
month:Number — Um inteiro de 0 (janeiro) a 11 (dezembro).
| |
day:Number — Um inteiro de 1 a 31.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
monthLabels com os elementos janeiro a dezembro e um novo objeto Month now sem parâmetros. O método getMonth() é então chamado, recuperando o mês no qual now foi criado. Em seguida, setMonth() é chamado com o parâmetro month definido como 0 e, depois, getMonth() é chamado novamente, recuperando o mês recém-definido..
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 | () | método |
AS3 function setSeconds(second:Number, millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define os segundos, de acordo com o horário local, e retorna o novo horário em milésimos de segundo. O horário local é determinado pelo sistema operacional no qual o tempo de execução do Flash está sendo executado.
Parâmetros
second:Number — Um inteiro de 0 a 59.
| |
millisecond:Number — Um inteiro de 0 a 999.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getseconds() é então chamado, recuperando os segundos quando now foi criado. Em seguida, setSeconds() é chamado com o parâmetro second definido como 0 e getSeconds() é chamado novamente, recuperando os segundos recém-definidos.
var now:Date = new Date(); trace(now.getSeconds()); now.setSeconds(0); trace(now.getSeconds()); // 0
setTime | () | método |
AS3 function setTime(millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define a data em milésimos de segundo, desde a meia-noite de 1° de janeiro de 1970, e retorna o novo horário em milésimos de segundo.
Parâmetros
millisecond:Number — Um valor inteiro em que 0 é meia-noite em 1° de janeiro, horário universal (UTC).
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método setTime() é então chamado, com o parâmetro millisecond definido como -1292601600000, que define o horário como 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 | () | método |
AS3 function setUTCDate(day:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define o dia do mês, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. Chamar esse método não modifica os outros campos de um objeto Date, mas os métodos Date.getUTCDay() e Date.getDay() poderão reportar um novo valor se o dia da semana for alterado como resultado da chamada desse método.
Parâmetros
day:Number — Um número; um inteiro de 1 a 31.
|
Number — O novo horário, em milésimos de segundo.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getUTCDate() é chamado e retorna corretamente o dia do mês. Em seguida, setUTCDate() é chamado com o parâmetro day definido como 1 e uma instrução trace() confirma que a data foi corretamente definida.
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 | () | método |
AS3 function setUTCFullYear(year:Number, month:Number, day:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define o ano, no horário universal (UTC), e retorna o novo horário em milésimos de segundo.
Opcionalmente, esse método também pode definir o mês e o dia do mês. Chamar esse método não modifica os outros campos, mas Date.getUTCDay() e Date.getDay() poderão reportar um novo valor se o dia da semana for alterado como resultado da chamada desse método.
Parâmetros
year:Number — Um inteiro que representa o ano especificado como ano completo de quatro dígitos, como 2000.
| |
month:Number — Um inteiro de 0 (janeiro) a 11 (dezembro).
| |
day:Number — Um inteiro de 1 a 31.
|
Number — Um inteiro.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). O método getUTCFullYear() é chamado e retorna corretamente o ano de quatro dígitos. Em seguida, setUTCFullYear() é chamado com o parâmetro year definido como 1975 e uma instrução trace() confirma que o ano foi corretamente definido.
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 | () | método |
AS3 function setUTCHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define a hora, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. Opcionalmente, os minutos, os segundos e os milésimos de segundo podem ser especificados.
Parâmetros
hour:Number — Um inteiro de 0 (meia-noite) a 23 (11 p.m.).
| |
minute:Number — Um inteiro de 0 a 59.
| |
second:Number — Um inteiro de 0 a 59.
| |
millisecond:Number — Um inteiro de 0 a 999.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20). Os métodos getHours(), getMinutes(), getUTCHours() e getUTCMinutes() são então chamados, recuperando as horas e os minutos. Em seguida, setUTCHours() é chamado com o parâmetro hour definido como 12 e, depois, os métodos getHours(), getMinutes(), getUTCHours() e getUTCMinutes() são chamados novamente e exibem corretamente a hora atualizada.
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 | () | método |
AS3 function setUTCMilliseconds(millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define os milésimos de segundo, no horário universal (UTC), e retorna o novo horário em milésimos de segundo.
Parâmetros
millisecond:Number — Um inteiro de 0 a 999.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getUTCMilliseconds() é então chamado, recuperando os milésimos de segundo UTC quando now foi criado. Em seguida, outro objeto Date before com uma chamada adicional a setUTCMilliseconds() com o parâmetro millisecond definido como 4 e getUTCMilliseconds() é chamado novamente, recuperando os milésimos de segundo recém-definidos.
var now:Date = new Date(); trace(now); trace(now.getUTCMilliseconds()); var before:Date = new Date(now.setUTCMilliseconds(4)); trace(before); trace(before.getUTCMilliseconds());
setUTCMinutes | () | método |
AS3 function setUTCMinutes(minute:Number, second:Number, millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define os minutos, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. Opcionalmente, você pode especificar os segundos e milésimos de segundo.
Parâmetros
minute:Number — Um inteiro de 0 a 59.
| |
second:Number — Um inteiro de 0 a 59.
| |
millisecond:Number — Um inteiro de 0 a 999.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getUTCMinutes() é então chamado, recuperando os minutos UTC quando now foi criado. Em seguida, outro objeto Date before com uma chamada adicional a setUTCMinutes() com o parâmetro minute definido como 0 e getUTCMinutes() é chamado novamente, recuperando os minutos recém-definidos.
var now:Date = new Date(); trace(now); trace(now.getUTCMinutes()); var before:Date = new Date(now.setUTCMinutes(0)); trace(before); trace(before.getUTCMinutes());
setUTCMonth | () | método |
AS3 function setUTCMonth(month:Number, day:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define o mês e, opcionalmente, o dia, no horário universal (UTC), e retorna o novo horário em milésimos de segundo. Chamar esse método não modifica os outros campos, mas Date.getUTCDay() e Date.getDay() poderão reportar um novo valor se o dia da semana for alterado como resultado da chamada desse método.
Parâmetros
month:Number — Um inteiro de 0 (janeiro) a 11 (dezembro).
| |
day:Number — Um inteiro de 1 a 31.
|
Number — O novo horário, em milésimos de segundo.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
UTCMonthLabels com os elementos janeiro a dezembro e um novo objeto UTCMonth now sem parâmetros. O método getUTCMonth() é então chamado, recuperando o Mês UTC no qual now foi criado. Em seguida, setUTCMonth() é chamado com o parâmetro month definido como 0 e, depois, getUTCMonth() é chamado novamente, recuperando o mês recém-definido..
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 | () | método |
AS3 function setUTCSeconds(second:Number, millisecond:Number):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Define os segundos e, opcionalmente, os milésimos de segundo, no horário universal (UTC), e retorna o novo horário em milésimos de segundo.
Parâmetros
second:Number — Um inteiro de 0 a 59.
| |
millisecond:Number — Um inteiro de 0 a 999.
|
Number — O novo horário, em milésimos de segundo.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getUTCSeconds() é então chamado, recuperando os segundos quando now foi criado. Em seguida, setUTCSeconds() é chamado com o parâmetro second definido como 0 e getUTCSeconds() é chamado novamente, recuperando os segundos recém-definidos.
var now:Date = new Date(); trace(now.getUTCSeconds()); now.setUTCSeconds(0); trace(now.getUTCSeconds()); // 0
toDateString | () | método |
AS3 function toDateString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna uma representação de string do dia e da data apenas e não inclui o horário ou o fuso horário. Contraste com os seguintes métodos:
Date.toTimeString(), que retorna apenas o horário e o fuso horárioDate.toString(), que retorna não só o dia e a data, como também o horário e o fuso horário
String — A representação de string do dia e da data apenas.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
now sem parâmetros e, em seguida, os seguintes métodos são chamados em uma instrução trace()
toString: exibe todos os parâmetros paranowno momento em quenowfoi criado.toDateString(): exibe os parâmetrosday,montheyearpara o momento em quenowfoi criado.
var now:Date = new Date(); trace(now); trace(now.toDateString());
toJSON | () | método |
AS3 function toJSON(k:String):*| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 11, AIR 3, Flash Lite 4 |
Fornece um método que pode ser substituído para personalizar a codificação JSON de valores em um objeto Date.
O método JSON.stringify() procura um método toJSON() em cada objeto que percorre. Se o método toJSON() for encontrado, JSON.stringify() o invocará para cada valor que encontrar, passando a chave emparelhada ao valor.
A data fornece uma implementação padrão de toJSON () que retorna a saída de Date.toString (). Os clientes que desejam exportar objetos Date para JSON em qualquer outro formato podem fornecer as suas próprias implementações. Você pode fazer isto redefinindo o toJSON () método no protótipo de classe.
O método toJSON() pode retornar um valor de qualquer tipo. Se retornar um objeto, stringify() aplicará funções recursivas a esse objeto. Se toJSON() retornar uma string, stringify() não usará funções recursivas e continuará sua travessia.
Parâmetros
k:String — A chave de um par de chave/valor que JSON.stringify() encontrou durante a travessia desse objeto
|
* — O valor do objeto de Date.toString().
|
Elementos da API relacionados
Object.prototype
toLocaleDateString | () | método |
AS3 function toLocaleDateString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna uma representação de String do dia e da data apenas e não inclui o horário ou o fuso horário. Esse método retorna o mesmo valor que Date.toDateString. Contraste com os seguintes métodos:
Date.toTimeString(), que retorna apenas o horário e o fuso horárioDate.toString(), que retorna não só o dia e a data, como também o horário e o fuso horário
String — A representação de String do dia e da data apenas.
|
Elementos da API relacionados
toLocaleString | () | método |
AS3 function toLocaleString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna uma representação de String do dia, da data e do horário, fornecida no horário local. Contraste com o método Date.toString(), que retorna as mesmas informações (mais o fuso horário), com o ano listado no final da string.
String — Uma representação de string de um objeto Date no fuso horário local.
|
toLocaleTimeString | () | método |
AS3 function toLocaleTimeString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna uma representação de String do horário apenas e não inclui o dia, a data, o ano ou o fuso horário. Contraste com o método Date.toTimeString(), que retorna o horário e o fuso horário.
String — A representação de string do horário e do fuso horário apenas.
|
Elementos da API relacionados
toString | () | método |
AS3 function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna uma representação de String do dia, da data, do horário e do fuso horário. O formato de data para a saída é:
Day Mon Date HH:MM:SS TZD YYYY
Por exemplo:
Wed Apr 12 15:30:17 GMT-0700 2006
RetornaString — A representação de string de um objeto Date.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros e, em seguida, toString é chamado em uma instrução trace(), que exibe todos os parâmetros para now no momento em que now foi criado.
var now:Date = new Date(); trace(now);
toTimeString | () | método |
AS3 function toTimeString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna uma representação de String do horário e do fuso horário apenas e não inclui o dia e a data. Contraste com o método Date.toDateString(), que retorna apenas o dia e a data.
String — A representação de string do horário e do fuso horário apenas.
|
Elementos da API relacionados
toUTCString | () | método |
AS3 function toUTCString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna uma representação de String do dia, da data e do horário no horário universal (UTC). Por exemplo, a data 1° de fevereiro de 2005 é retornada como Terça-feira, 1° de fevereiro 00:00:00 2005 UTC.
String — A representação de string de um objeto Date no horário UTC.
|
Elementos da API relacionados
UTC | () | método |
public static function UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o número de milésimos de segundo entre a meia-noite de 1° de janeiro de 1970, horário universal, e o horário especificado nos parâmetros. Esse método usa o horário universal, enquanto o construtor de Date usa o horário local.
Esse método será útil se você quiser transmitir uma data UTC ao construtor da classe Date. Como o construtor da classe Date aceita o deslocamento de milésimos de segundo como um argumento, você pode usar o método Date.UTC() para converter a data UTC no deslocamento de milésimos de segundo correspondente e enviar esse deslocamento como um argumento para o construtor da classe Date:
Parâmetros
year:Number — Um inteiro de quatro dígitos que representa o ano (por exemplo, 2000).
| |
month:Number — Um inteiro de 0 (janeiro) a 11 (dezembro).
| |
date:Number (default = 1) | |
hour:Number (default = 0) | |
minute:Number (default = 0) | |
second:Number (default = 0) | |
millisecond:Number (default = 0) |
Number — O número de milésimos de segundo desde 1° de janeiro de 1970 e a data e a hora especificadas.
|
Exemplo ( Como usar este exemplo )
someBirthday com os parâmetros year (1974), month (10 = novembro), day (30), hour (1) e minute (20) usando o horário local. Em seguida, uma chamada a UTC() em um método setTime() redefine os mesmos parâmetros para o horário universal.
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 | () | método |
AS3 function valueOf():Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Retorna o número de milésimos de segundo desde a meia-noite de 1° de janeiro de 1970, horário universal, para um objeto Date.
Number — O número de milésimos de segundo desde 1° de janeiro de 1970 que um objeto Date representa.
|
Exemplo ( Como usar este exemplo )
now sem parâmetros. O método getTime() é então chamado, recuperando o número de milésimos de segundo entre o momento em que now foi criado e a meia-noite de 1° de janeiro de 1970. Em seguida, valueOf() é chamado, recuperando a mesma coisa.
var now:Date = new Date(); trace(now.getTime()); trace(now.valueOf());
Date() para atribuir as seguintes variáveis:
myDate1chamaDate()sem parâmetros, que definemyDate1como a data e a hora atuais (de acordo com a data e a hora do sistema atual).myDate2chamaDate()com os parâmetrosyear(2000), mês (0= janeiro) eday(1) transmitidos.myDate3chamaDate()com os oyear(65= 1965), omonth(2= março), oday(6), ahour(9), ominute(30), osecond(15) e omillisecond-+ (0) transmitidos como parâmetros.myDate4chamaDate()com o valor de hora representando o número de milésimos de segundo antes de (já que o valor é negativo) 0:00:00 GMT de 1° de janeiro de 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
}
}
}
Wed Jun 13 2018, 11:10 AM Z