Retorna os componentes individuais de um valor de data/hora.

Descrição

A função Day retorna o componente do dia de um valor de data/hora, variando de 1 a 31.

A função Month retorna o componente do mês de um valor de data/hora, variando de 1 a 12.

A função Year retorna o componente do ano de um valor de data/hora, começando com 1900.

A função Hour retorna o componente da hora de um valor de data/hora, variando de 0 (12:00 AM) a 23 (11:00PM).

A função Minute retorna o componente do minuto de um valor de data/hora, variando de 0 a 59.

A função Second retorna o componente do segundo de um valor de data/hora, variando de 0 a 59.

A função Weekday retorna o dia da semana de um valor de data/hora. Por padrão, o resultado varia de 1 (domingo) a 7 (sábado). Você pode especificar um intervalo diferente com um código da função Weekday do Microsoft Excel ou um valor de enumeração StartOfWeek:

Código do Excel Enumeração StartOfWeek Descrição
1, 17 StartOfWeek.Sunday Números de 1 (domingo) a 7 (sábado). Padrão.
2, 11 StartOfWeek.Monday Números de 1 (segunda-feira) a 7 (domingo).
3 StartOfWeek.MondayZero Números de 0 (segunda-feira) a 6 (domingo).
12 StartOfWeek.Tuesday Números de 1 (terça-feira) a 7 (segunda-feira).
13 StartOfWeek.Wednesday Números de 1 (quarta-feira) a 7 (terça-feira).
14 StartOfWeek.Thursday Números de 1 (quinta-feira) a 7 (quarta-feira).
15 StartOfWeek.Friday Números de 1 (sexta-feira) a 7 (quinta-feira).
16 StartOfWeek.Saturday Números de 1 (sábado) a 7 (sexta-feira).

Todas as funções retornam um número.

Consulte Trabalhar com datas e horas para obter mais informações.

Sintaxe

Day( DateTime )
Month( DateTime )
Year( DateTime )
Hour( DateTime )
Minute( DateTime )
Second( DateTime )

  • DateTime - obrigatório. Valor de data/hora no qual operar.

Weekday( DateTime [, WeekdayFirst ] )

  • DateTime - obrigatório. Valor de data/hora no qual operar.
  • WeekdayFirst - Opcional. Código do Excel que especifica em qual dia inicia a semana. Se não for fornecido, 1 (domingo primeiro) é usado.

Exemplos

Para o exemplo a seguir, a hora atual é 3:59:37 PM na quinta-feira, 9 de abril de 2015.

Fórmula Descrição Resultado
Year( Now() ) Retorna o componente do ano da data e hora atual. 2015
Month( Now() ) Retorna o componente do mês da data e hora atual. 4
Day( Now() ) Retorna o componente do dia da data e hora atual. 9
Hour( Now() ) Retorna o componente da hora da data e hora atual. 15
Minute( Now() ) Retorna o componente do minuto da data e hora atual. 59
Second( Now() ) Retorna o componente do minuto da data e hora atual. 37
Weekday( Now() ) Retorna o componente do dia da semana da data e hora atuais, usando o padrão de início da semana como domingo. 5
Weekday( Now(), 14 ) Retorna o componente do dia da semana da data e hora atuais, usando um código do Excel para especificar o início da semana como quinta-feira. 1
Weekday( Now(), StartOfWeek.Wednesday ) Retorna o componente do dia da semana da data e hora atuais, usando uma enumeração StartOfWeek para especificar o início da semana como quarta-feira. 2