Funções Day, Month, Year, Hour, Minute, Second e Weekday
Aplica-se a:
Aplicativos de tela Colunas de fórmula do Dataverse Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI
Retorna os componentes individuais de um valor Date/Time.
Descrição
A função Day retorna o componente do dia de um valor Date/Time, variando de 1 a 31.
A função Month retorna o componente do mês de um valor Date/Time, variando de 1 a 12.
A função Year retorna o componente do ano de um valor Date/Time, começando com 1900.
A função Hour retorna o componente da hora de um valor Date/Time, variando de 0 (meia-noite) a 23 (23h).
A função Minute retorna o componente do minuto de um valor Date/Time, variando de 0 a 59.
A função Second retorna o componente do segundo de um valor Date/Time, variando de 0 a 59.
A função Weekday retorna o dia da semana de um valor Date/Time. Por padrão, o resultado varia de 1 (domingo) a 7 (sábado). Você pode especificar um intervalo diferente com um código de 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) será usado.
Exemplos
Para o exemplo a seguir, a hora atual é 15:59:37 na quinta-feira, 9 de abril de 2015.
| Fórmula | Descrição | Resultado |
|---|---|---|
| Year( Now() ) | Retorna o componente de 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 segundo da data e hora atual. | 37 |
| Weekday( Now() ) | Retorna o componente do dia da semana da data e hora atual, 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 atual, 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 atual, usando uma enumeração StartOfWeek para especificar o início da semana como quarta-feira. | 2 |