Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
Aplicativos de tela O Copilot Studio Desktop flui colunas de fórmula do Dataverse para aplicativos controlados por modelos do Power Platform CLI Dataverse functions Power Pages
Retorna os componentes individuais de um valor Date/Time.
Descrição
A Day função retorna o componente de dia de um valor de data/hora, variando de 1 a 31.
A Month função retorna o componente mensal de um valor de Data/Hora, variando de 1 a 12.
A Year função retorna o componente de ano de um valor de Data/Hora, começando com 1900.
A Hour função retorna o componente de hora de um valor de Data/Hora, variando de 0 (0:00) a 23 (23:00 PM).
A Minute função retorna o componente de minuto de um valor de Data/Hora, variando de 0 a 59.
A Second função retorna o segundo componente de um valor de Data/Hora, variando de 0 a 59.
A Weekday função 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 de função do Microsoft Excel Weekday ou um valor de enumeração StartOfWeek:
| Código do Excel | Enumeração StartOfWeek | Descrição |
|---|---|---|
| 1, 17 | InícioDaSemana.Domingo | Números de 1 (domingo) a 7 (sábado). Padrão. |
| 2, 11 | InícioDaSemana.Segunda-feira | Números de 1 (segunda-feira) a 7 (domingo). |
| 3 | InícioDaSemana.Segunda-feiraZero | Números de 0 (segunda-feira) a 6 (domingo). |
| 12 | InícioDaSemana.Terça-feira | Números de 1 (terça-feira) a 7 (segunda-feira). |
| 13 | InícioDaSemana.Quarta-feira | Números de 1 (quarta-feira) a 7 (terça-feira). |
| 14 | InícioDaSemana.Quinta-feira | Números de 1 (quinta-feira) a 7 (quarta-feira). |
| 15 | InícioDaSemana.Sexta-feira | Números de 1 (sexta-feira) a 7 (quinta-feira). |
| 16 | InícioDaSemana.Sábado | 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 |