Funções Day, Month, Year, Hour, Minute, Second e Weekday
Aplica-se a:
Aplicações de tela Colunas de fórmula do Dataverse Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Pages Power Platform CLI
Devolve os componentes individuais de um valor de Data/Hora.
Descrição
A função Day devolve o componente referente ao dia de um valor de Data/Hora, que corresponde a um número entre 1 e 31.
A função Month devolve o componente referente ao mês de um valor de Data/Hora, que corresponde a um número entre 1 e 12.
A função Year devolve o componente referente ao ano de um valor de Data/Hora, que corresponde a um número a partir de 1900.
A função Hour devolve o componente referente à hora de um valor de Data/Hora, que corresponde a um número entre 0 (00:00) e 23 (23:00).
A função Minute devolve o componente referente aos minutos de um valor de Data/Hora, que corresponde a um número entre 0 e 59.
A função Second devolve o componente referente aos segundos de um valor de Data/Hora, que corresponde a um número entre 0 e 59.
A função Weekday devolve o dia da semana de um valor de Data/Hora. Por predefinição, o resultado encontra-se num intervalo entre 1 (domingo) e 7 (sábado). Pode especificar um intervalo diferente com um valor de enumeração StartOfWeek ou um código de função Weekday do Microsoft Excel:
| Código do Excel | Enumeração StartOfWeek | Descrição |
|---|---|---|
| 1, 17 | StartOfWeek.Sunday | Números entre 1 (domingo) e 7 (sábado). Predefinição. |
| 2, 11 | StartOfWeek.Monday | Números entre 1 (segunda-feira) e 7 (domingo). |
| 3 | StartOfWeek.MondayZero | Números entre 0 (segunda-feira) e 6 (domingo). |
| 12 | StartOfWeek.Tuesday | Números entre 1 (terça-feira) e 7 (segunda-feira). |
| 13 | StartOfWeek.Wednesday | Números entre 1 (quarta-feira) e 7 (terça-feira). |
| 14 | StartOfWeek.Thursday | Números entre 1 (quinta-feira) e 7 (quarta-feira). |
| 15 | StartOfWeek.Friday | Números entre 1 (sexta-feira) e 7 (quinta-feira). |
| 16 | StartOfWeek.Saturday | Números entre 1 (sábado) e 7 (sexta-feira). |
Todas as funções devolvem um número.
Consulte Trabalhar com datas e horas, para obter mais informações.
Sintaxe
Day( DataHora )
Month( DataHora )
Year( DateTime )
Hour( DataHora )
Minute( DataHora )
Second( DataHora )
- DateTime – Necessário. Valor Data/Hora a utilizar.
Weekday( DataHora [, PrimeiroDiaDaSemana ] )
- DateTime – Necessário. Valor Data/Hora a utilizar.
- WeekdayFirst – Opcional. Código do Excel que especifica o dia em que a semana começa. Se tal não for indicado, é utilizado o valor 1 (o primeiro dia da semana é o domingo).
Exemplos
Para o exemplo seguinte, a hora atual é 15:59:37 de quinta-feira, 9 de abril de 2015.
| Fórmula | Descrição | Resultado |
|---|---|---|
| Year( Now() ) | Devolve o componente referente ao ano da data e hora atual. | 2015 |
| Month( Now() ) | Devolve o componente referente ao mês da data e hora atual. | 4 |
| Day( Now() ) | Devolve o componente referente ao dia da data e hora atual. | 9 |
| Hour( Now() ) | Devolve o componente referente à hora da data e hora atual. | 15 |
| Minute( Now() ) | Devolve o componente referente à hora da data e hora atual. | 59 |
| Second( Now() ) | Devolve o componente de segundos referente à hora e data atual. | 37 |
| Weekday( Now() ) | Devolve o componente referente ao dia da semana da data e hora atual, ao utilizar o domingo como o início da semana predefinido. | 5 |
| Weekday( Now(), 14 ) | Devolve o componente referente ao dia da semana da data e hora atual e utiliza um código do Excel para especificar que o início da semana é à quinta-feira. | 1 |
| Weekday( Now(), StartOfWeek.Wednesday ) | Devolve o componente referente ao dia da semana da data e hora atual e utiliza uma enumeração StartOfWeek para especificar que o início da semana ocorre à quarta-feira. | 2 |