|
|
|
|
|
|
|
|
Dicas
|
|
|
Visual Basic (Datas/Números/Strings)
|
|
 |
Título da Dica: Incluindo (dia, mês, ano, trimestre, hora, minuto, segundo) em uma data
|
 |
|
|
|
Postada em 22/8/2003 por d@®l@n
Função DateAdd
Retorna uma Variant (Date) que contém uma data à qual foi adicionado um intervalo de tempo especificado.
Sintaxe
DateAdd(interval, number, date)
A sintaxe da função DateAdd tem os seguintes argumentos nomeados:
Parte Descrição
interval Necessário. Expressão de seqüência que é o intervalo de tempo que você deseja adicionar.
number Necessário. Expressão numérica que é o número de intervalos que você deseja adicionar. Ela pode ser positiva (para obter datas futuras) ou negativa (para obter datas anteriores).
date Necessário. Variant (Date) ou literal que representa a data à qual o intervalo é adicionado.
Configurações
O argumento interval tem as seguintes configurações:
Configuração Descrição
yyyy Ano
q Trimestre
m Mês
y Dia do ano
d Dia
w Dia da semana
ww Semana
h Hora
n Minuto
s Segundo
Comentários
Você pode usar a função DateAdd para adicionar ou subtrair um intervalo de tempo especificado de uma data. Por exemplo, você pode usar DateAdd para calcular uma data de hoje a 30 dias ou uma hora a 45 minutos deste momento.
Para adicionar dias a date, você pode usar Dia do ano ("y"), Dia ("d") ou Dia da semana ("w").
A função DateAdd não retorna uma data inválida. O exemplo a seguir adiciona um mês a 31 de janeiro:
DateAdd("m", 1, "31-Jan-95")
Neste caso, DateAdd retorna 28-Feb-95 e não 31-Feb-95. Se date for 31-Jan-95, retornará 29-Feb-96, pois 1996 é um ano bissexto.
Se a data calculada for anterior ao ano 100 (isto é, você subtrair mais anos do que existem em date), ocorrerá um erro.
Se number não for um valor Long, será arredondado para o número inteiro mais próximo antes de ser avaliado.
Observação O formato do valor retornado para DateAdd é determinado pelas configurações do Painel de Controle e não pelo formato passado no argumento date.
Função DateSerial
Retorna uma Variant (Date) para um ano, mês e dia especificados.
Sintaxe
DateSerial(year, month, day)
A sintaxe da função DateSerial tem os seguintes argumentos nomeados:
Parte Descrição
year Necessário; Integer. Número entre 100 e 9999, inclusive, ou uma expressão numérica.
month Necessário; Integer. Qualquer expressão numérica.
day Necessário; Integer. Qualquer expressão numérica.
Comentários
Para especificar uma data, como 31 de dezembro de 1991, o intervalo de números para cada argumento de DateSerial deve estar no intervalo aceito para a unidade, isto é, 1–31 para dias e 1–12 para meses. Entretanto, você também pode especificar datas relativas para cada argumento usando qualquer expressão numérica que represente algum número de dias, meses ou anos, antes ou depois de uma determinada data.
O exemplo a seguir usa expressões numéricas em vez de números absolutos de data. Aqui a função DateSerial retorna uma data que é o dia anterior ao primeiro dia (1 - 1), dois meses antes de agosto (8 - 2), 10 anos antes de 1990 (1990 - 10); em outras palavras, 31 de maio de 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Para o argumento year, os valores entre 0 e 29, inclusive, são interpretados como os anos 2000–2029. Os valores entre 30 e 99 são interpretados como os anos 1930–1999. Para todos os demais argumentos year, use um ano de quatro dígitos (por exemplo, 1800).
Quando qualquer argumento exceder o intervalo aceito para esse argumento, ele será incrementado até a próxima unidade maior, da maneira apropriada. Por exemplo, se você especificar 35 dias, resultará em um mês e alguns dias, dependendo em que época do ano seja aplicado. Se qualquer argumento único estiver fora do intervalo -32,768 a 32,768, ocorrerá um erro. Se a data especificada pelos três argumentos ficar fora do intervalo de datas aceitável, ocorrerá um erro.
Função DatePart
Retorna uma Variant (Integer) que contém a parte especificada de uma determinada dada.
Sintaxe
DatePart(interval, date[,firstdayofweek[, firstweekofyear]])
A sintaxe da função DatePart tem os seguintes argumentos nomeados:
Parte Descrição
interval Necessário. Expressão de seqüência que é o intervalo de tempo que você deseja retornar.
date Necessário. Valor de Variant (Date) que você deseja avaliar.
firstdayofweek Opcional. Uma constante que especifica o primeiro dia da semana. Se não for especificada, será considerado o domingo.
firstweekofyear Opcional. Uma constante que especifica a primeira semana do ano. Se não for especificada, será considerada aquela em que ocorre o dia 1º de janeiro.
Configurações
O argumento interval tem as seguintes configurações:
Configuração Descrição
yyyy Ano
q Trimestre
m Mês
y Dia do ano
d Dia
w Dia da semana
ww Semana
h Hora
n Minuto
s Segundo
O argumento firstdayofweek tem as seguintes configurações:
Constante Valor Descrição
vbUseSystem 0 Usa a configuração NLS API.
vbSunday 1 Domingo (padrão)
vbMonday 2 Segunda-feira
vbTuesday 3 Terça-feira
vbWednesday 4 Quarta-feira
vbThursday 5 Quinta-feira
vbFriday 6 Sexta-feira
vbSaturday 7 Sábado
O argumento firstweekofyear tem as seguintes configurações:
Constante Valor Descrição
vbUseSystem 0 Usa a configuração NLS API.
vbFirstJan1 1 Inicia com a semana na qual ocorre o dia 1 de janeiro (padrão).
vbFirstFourDays 2 Inicia com a primeira semana que tem pelo menos quatro dias no ano novo.
vbFirstFullWeek 3 Inicia com a primeira semana completa do ano.
Comentários
Você pode usar a função DatePart para avaliar uma data e retornar um intervalo de tempo específico. Por exemplo, você pode usar DataPart para calcular o dia da semana ou a hora atual.
O argumento firstdayofweek afeta cálculos que usam os símbolos de intervalo "w" e "ww".
Se date for um literal de data, o ano especificado se tornará uma parte permanente dessa data. Entretanto, se date estiver entre aspas duplas (" ") e você omitir o ano, o ano atual será inserido no seu código sempre que a expressão date for avaliada. Isso torna possível gravar o código que pode ser usado em anos diferentes.
|
|
|
|
|
