Objeto Date

Artigo
08/01/2011

Um objeto que permite o armazenamento básico e a recuperação de datas e horas. Existem duas formas do Date construtor.

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )

Argumentos

dateVal
Opcional. Se um valor numérico, dateVal representa o número de milissegundos no tempo Universal Coordenado entre a data especificada e a meia-noite de 1º de janeiro de 1970. Se uma seqüência de caracteres, dateVal é analisada de acordo com para as regras de Analisar método. O dateVal também pode ser um.Valor de data NET.
year
Obrigatório. Todo o ano, por exemplo, 1976 (não 76).
mês
Obrigatório. O mês como um número inteiro entre 0 e 11 (janeiro a dezembro).
date
Obrigatório. A data como um número inteiro entre 1 e 31.
hours
Opcional. Deve ser fornecido se minutos for fornecida. Um inteiro de 0 a 23 (meia-noite às 11 horas) que especifica a hora.
minutos
Opcional. Deve ser fornecido se segundos for fornecida. Um inteiro de 0 a 59 que especifica os minutos.
segundos
Opcional. Deve ser fornecido se milissegundos for fornecida. Um inteiro de 0 a 59 que especifica os segundos.
ms
Opcional. Um inteiro de 0 a 999 que especifica o tipo de milissegundos.

Comentários

A Date objeto contém um número que representa uma instância específica de tempo dentro de um milissegundo. Se o valor de um argumento é maior do que o seu intervalo ou um número negativo, outros valores armazenados são modificados de acordo. Por exemplo, se você especificar 150 segundos, o JScript redefine esse número como dois minutos e 30 segundos.

Se o número for NaN, o objeto não representa uma instância específica no tempo. Se você passar sem parâmetros para o Date construtor, ele é inicializado para a hora atual (UTC). Uma variável do tipo Date deve ser inicializada antes que você pode usá-lo.

O intervalo de datas que podem ser representados em um Date o objeto é de aproximadamente 285,616 anos em ambos os lados de 1º de janeiro de 1970.

O Date o objeto tem dois métodos estáticos, Analisar e UTC, que são chamados sem criar um Date objeto.

Se a Date construtor é chamado sem a nova operador, o Date objeto que é retornado contém a data atual, independentemente dos argumentos passados para o construtor.

Observação
O Date objeto interopera com o.NET Framework DateTime o tipo de dados dentro de JScript. No entanto, outros idiomas do Common Language Specification (CLS) não é possível usar o Date porque somente o JScript fornece o objeto; ele não é derivado de um.Tipo do NET Framework. Conseqüentemente, quando o tipo-anotando os parâmetros e tipos de retorno dos métodos compatíveis com CLS, certifique-se de usar o DateTime o tipo de dados em vez da Date objeto. Entretanto, você pode usar o Date objeto digitar anotar identificadores diferente de parâmetros ou tipos de retorno. Para obter mais informações, consulte Escrevendo código compatível com CLS.

O Date objeto interopera com o.NET Framework DateTime o tipo de dados dentro de JScript. No entanto, outros idiomas do Common Language Specification (CLS) não é possível usar o Date porque somente o JScript fornece o objeto; ele não é derivado de um.Tipo do NET Framework. Conseqüentemente, quando o tipo-anotando os parâmetros e tipos de retorno dos métodos compatíveis com CLS, certifique-se de usar o DateTime o tipo de dados em vez da Date objeto. Entretanto, você pode usar o Date objeto digitar anotar identificadores diferente de parâmetros ou tipos de retorno. Para obter mais informações, consulte Escrevendo código compatível com CLS.

Consulte Cálculos de data e hora para obter mais informações sobre como usar o Date objeto e métodos relacionados.

Exemplo

O exemplo a seguir usa a Date objeto.

var s : String = "Today's date is: ";   // Declare variables.
var d : Date = new Date();              // Create Date object with today's date.
s += (d.getMonth() + 1) + "/";          // Get month
s += d.getDate() + "/";                 // Get day
s += d.getYear();                       // Get year.
print(s);                               // Print date.

Se este programa foi executado em 26 de janeiro de 1992, a saída seria: