Funções Day, Month, Year, Hour, Minute, Second e Weekday
Aplica-se a:
Aplicativos Canvas Dataverse Colunas de fórmula Fluxos de desktop Aplicativos baseados em modelo Power Pages 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 | 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
Dia( DataHora )
Mês( DataHora )
Ano( DataHora )
Hora( DataHora )
Minuto( DataHora )
Segundo( DataHora )
- DateTime - Obrigatório. Valor de data/hora no qual operar.
Dia da semana( DataHora [, Dia da semanaPrimeiro ] )
- 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 |
|---|---|---|
| Ano( Agora() ) | Retorna o componente de ano da data e hora atual. | 2015 |
| Mês(Agora()) | Retorna o componente do mês da data e hora atual. | 4 |
| Dia(Agora()) | Retorna o componente do dia da data e hora atual. | 9 |
| Hora(Agora()) | Retorna o componente da hora da data e hora atual. | 15 |
| Minuto(Agora()) | Retorna o componente do minuto da data e hora atual. | 59 |
| Segundo(Agora()) | Retorna o componente do segundo da data e hora atual. | 37 |
| Dia da semana(Agora()) | Retorna o componente do dia da semana da data e hora atual, usando o padrão de início da semana como domingo. | 5 |
| Dia da semana(Agora(), 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 |
| Dia da semana(Agora(), InícioDaSemana.Quarta-feira) | 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 |