Tópico AnteriorPróximo Tópico


Classe DateTimeSpan

A classe estática DateTimeSpan fornece funções para determinar a quantidade de tempo entre duas datas ou horários e para aumentar ou reduzir intervalos de tempo. Ela fornece um conjunto de funções para trabalhar com diferenças entre duas datas. Como os intervalos de data são apenas números, o aplicativo pode utilizar correspondências normais entre eles: multiplicação, divisão, adição, subtração e assim por diante. Essa classe é estática. O aplicativo não pode criar instâncias de classe.

DateTimeSpan.addDate

Esta função retorna uma nova data, que é a soma da adição de um dado número de anos, meses e dias para a data de início. Os meses podem ser maiores que 12 e os dias podem ser maiores que o número de dias em um mês. O efeito da rede é como se houvesse três operações diferentes. Primeiramente, adicione os anos. Depois, utilizando a data resultante, adicione os meses. Em seguida, utilizando a data resultante, adicione os dias.

Ao adicionar um mês, a data resultante pode não ser válida. Por exemplo, adicionar um mês para 31 de janeiro produziria a data inválida 31 de fevereiro. A função ajusta a data para que seja válida, assim, se o ano não for um ano bissexto, fevereiro terá 28 dias e a data resultante será 3 de março.

Qualquer um dos argumentos de anos, meses ou dias poderá ser nulo ou indefinido. Nesse caso, esse valor será tratado como se fosse zero.

Qualquer um dos argumentos de anos, meses ou dias poderá ser negativo. Nesse caso, o resultado será como se essa unidade tivesse sido subtraída da data base.

Sintaxe

DateTimeSpan.addDate( startDate, years, months, days )

Argumentos

Retornos

Uma data que resulta da adição de anos, meses e dias na data de início.

Exemplo

var startDate = date.parse( "2004-12-31" ); 
var endDate; 
endDate = DateTimeSpan( startDate, 1, 0, 0 ); // retorna 2005-12-31 
endDate = DateTimeSpan( startDate, 0, 1, 0 ); // retorna 2005-1-31 
endDate = DateTimeSpan( startDate, 0, 0, 1 ); // retorna 2005-1-1 
endDate = DateTimeSpan( startDate, 1, 1, 1 ); // retorna 2005-3-4 

Consulte também

Função DateTimeSpan.addTime

Função DateTimeSpan.subDate

DateTimeSpan.addTime

Esta função retorna uma nova data, que é a soma da adição de um dado número de horas, minutos e segundos para a data de início. As horas podem ser maiores que 24 e os minutos e segundos podem ser maiores que 60. O efeito da rede é como se houvesse operações diferentes. Primeiramente, adicione as horas. Depois, utilizando a data resultante, adicione os minutos. Em seguida, utilizando a data resultante, adicione os segundos.

Qualquer um dos argumentos de horas, minutos ou segundos poderá ser nulo ou indefinido. Nesse caso, esse valor será tratado como se fosse zero.

Qualquer um dos argumentos de horas, minutos ou segundos poderá ser negativo. Nesse caso, o resultado será como se essa unidade tivesse sido subtraída da data base.

Sintaxe

DateTimeSpan.addTime( startDate, hours, minutes, seconds )

Argumentos

Retornos

Uma data que resulta da adição de horas, minutos e segundos na data de início.

Consulte também

Função DateTimeSpan.addDate

Função DateTimeSpan.subTime

DateTimeSpan.days

Retorna o número de dias entre duas datas. Um dia é definido como uma alteração do calendário. Assim, 23:59:59 de 27 de fevereiro até meia-noite de 28 de fevereiro será um dia, bem como meia-noite de 27 de fevereiro até 23:59:59 de 28 de fevereiro.

Sintaxe

DateTimeSpan.days( startDate, endDate )

Argumentos

Retornos

O número de retornos de dias entre duas datas.

DateTimeSpan.hours

Esta função retorna o número de horas completas entre dois horários. Uma hora completa é um intervalo definido a partir de um dado minuto de hora em hora, para o mesmo minuto na próxima hora. Por exemplo, 1:23:00 a 2:23:00 é uma hora, enquanto 1:23:00 a 2:22:59 não é uma hora completa.

Sintaxe

DateTimeSpan.hours( startDate, endDate )

Argumentos

Retornos

O número de horas completas entre duas datas.

DateTimeSpan.minutes

Esta função retorna o número de minutos completos entre dois horários. Um minuto completo é um intervalo definido a partir de um dado segundo de um minuto, para o mesmo segundo no próximo minuto. Por exemplo, 1:23:00 a 1:24:00 é um minuto, enquanto 1:23:00 a 1:22:59 não é um minuto completo.

Sintaxe

DateTimeSpan.minutes( startDate, endDate )

Argumentos

Retornos

O número de minutos completos entre duas datas.

DateTimeSpan.months

Esta função retorna o número de meses completos entre duas datas. Um mês completo é um intervalo de tempo definido a partir do último dia de um mês até o último dia do mês seguinte. Por exemplo, 28 de fevereiro até 28 de março é um mês, enquanto 28 de fevereiro a 26 de março não é um mês completo.

Sintaxe

DateTimeSpan.months( startDate, endDate )

Argumentos

Retornos

Retorna o número completo de meses entre duas datas.

DateTimeSpan.seconds

Esta função retorna o número de segundos entre dois horários.

Sintaxe

DateTimeSpan.seconds( startDate, endDate )

Argumentos

Retornos

O número de minutos completos entre duas datas.

DateTimeSpan.subDate

Esta função retorna uma nova data, que é o resultado da subtração de um dado número de anos, meses e dias da data de início. Os meses podem ser maiores que 12 e os dias podem ser maiores que o número de dias em um mês. O efeito da rede é como se houvesse três operações diferentes. Primeiramente, subtraia os anos. Depois, utilizando a data resultante, subtraia os meses. Em seguida, utilizando a data resultante, subtraia os dias.

Ao subtrair um mês, a data resultante pode não ser válida. Por exemplo, subtrair um mês de 30 de março produziria a data inválida 30 de fevereiro. A função ajusta a data para que seja válida, ajustando a data ao último dia válido no mês. Nesse caso, se o ano não for um ano bissexto, a data seria ajustada ao dia 28 de fevereiro.

Qualquer um dos argumentos de anos, meses ou dias poderá ser nulo ou indefinido. Nesse caso, esse valor será tratado como se fosse zero.

Qualquer um dos argumentos de anos, meses ou dias poderá ser negativo. Nesse caso, o resultado será como se essa unidade tivesse sido adicionada à data base.

Sintaxe

DateTimeSpan.subDate( startDate, years, months, days )

Argumentos

Retornos

Uma data que resulta da subtração de anos, meses e dias a partir da data de início.

Consulte também

Função DateTimeSpan.addDate

Função DateTimeSpan.subTime

DateTimeSpan.subTime

Esta função retorna uma nova data, que é o resultado da subtração de um dado número de horas, minutos e segundos a partir da data de início. As horas podem ser maiores que 24 e os minutos e segundos podem ser maiores que 60. O efeito da rede é como se houvesse três operações diferentes. Primeiramente, subtraia as horas. Depois, utilizando a data resultante, subtraia os minutos. Em seguida, utilizando a data resultante, subtraia os segundos.

Qualquer um dos argumentos de horas, minutos ou segundos poderá ser nulo ou indefinido. Nesse caso, esse valor será tratado como se fosse zero.

Qualquer um dos argumentos de horas, minutos ou segundos poderá ser negativo. Nesse caso, o resultado será como se essa unidade tivesse sido adicionada à data base.

Sintaxe

DateTimeSpan.subTime( startDate, hours, minutes, seconds )

Argumentos

Retornos

Uma data que resulta da subtração de horas, minutos e segundos a partir da data de início.

Consulte também

Função DateTimeSpan.addTime

Função DateTimeSpan.subDate

DateTimeSpan.years

Esta função computa o número de anos completos entre duas datas. Um ano completo é definido como iniciando a partir de um dado mês, dia e hora em um ano até o mesmo mês, dia e hora do ano seguinte. Por causa dos anos bissextos, um ano completo, às vezes, incluirá 365 dias; outras vezes, 366 dias.

Se um dos argumentos for diferente de uma data, uma exceção será lançada. Se um dos argumentos for nulo, o resultado também será nulo.

Sintaxe

DateTimeSpan.years( startDate, endDate )

Argumentos

Retornos

O número de anos completos entre duas datas.


(c) Direitos Autorais Actuate Corporation 2006

Tópico AnteriorPróximo Tópico