Funções Calendar e Clock
Aplica-se a:
Aplicativos de tela Aplicativos baseados em modelo
Recupera informações sobre o relógio e o calendário para a localidade atual.
Descrição
As funções Calendar e Clock são um conjunto de funções que recuperam informações sobre a localidade atual.
Você pode usar essas funções para exibir datas e horas no idioma do usuário atual. As tabelas de coluna única retornadas pelas funções Calendar e Clock podem ser usadas diretamente com a propriedade Items dos controles Dropdown e Listbox.
| Function | Descrição |
|---|---|
| Calendar.MonthsLong() | Tabela de coluna única que contém os nomes completos de cada mês, começando por "Janeiro". |
| Calendar.MonthsShort() | Tabela de coluna única que contém os nomes abreviados de cada mês, começando por "Jan" para janeiro. |
| Calendar.WeekdaysLong() | Tabela de coluna única que contém os nomes completos de cada dia da semana, começando por "Domingo". |
| Calendar.WeekdaysShort() | Tabela de coluna única que contém os nomes abreviados de cada dia da semana, começando por "Dom" para domingo. |
| Clock.AmPm() | Tabela de coluna única que contém as designações em letras maiúsculas de "AM" e "PM". Se o idioma usar um relógio de 24 horas, a tabela ficará vazia. |
| Clock.AmPmShort() | Tabela de coluna única que contém as designações em letras maiúsculas de "A" e "P". Se o idioma usar um relógio de 24 horas, a tabela ficará vazia. |
| Clock.IsClock24() | Booliano que indica se um relógio de 24 horas é usado nessa localidade. |
Use a função Text para formatar valores de data e hora usando essas mesmas informações. A função Language retorna o idioma atual e o código da região.
Sintaxe
Calendar.MonthsLong()
Calendar.MonthsShort()
Calendar.WeekdaysLong()
Calendar.WeekdaysShort()
Clock.AmPm()
Clock.AmPmShort()
Clock.IsClock24()
Exemplos
Insira um controle Dropdown.
Defina a fórmula para a propriedade Items para:
- Calendar.MonthsLong()
Agora, os usuários do seu aplicativo podem selecionar um mês em seus próprios idiomas. MonthsLong pode ser substituído por qualquer uma das tabelas de coluna única que são retornadas pela função Calendar para criar seletores de dia da semana e hora.
Nos Estados Unidos, com Language retornando "en-US", o seguinte é retornado pelas funções Calendar:
| Fórmula | Descrição | Resultado |
|---|---|---|
| Calendar.MonthsLong() | O valor de retorno contém o nome completo de cada mês, começando por "Janeiro". | [ "Janeiro", "Fevereiro", "Março", "Abril", "Maio", "Junho", "Julho", "Agosto", "Setembro", "Outubro", "Novembro", "Dezembro" ] |
| Calendar.MonthsShort() | O valor de retorno contém o nome abreviado de cada mês, começando por "Janeiro". | [ "Jan", "Fev", "Mar", "Abr", "Mai", "Jun", "Jul", "Ago", "Set", "Out", "Nov", "Dez" ] |
| Calendar.WeekdaysLong() | O valor de retorno contém o nome completo de cada dia, começando por "Domingo". | [ "Domingo", "Segunda-feira", "Terça-feira", "Quarta-feira", "Quinta-feira", "Sexta-feira", "Sábado" ] |
| Calendar.WeekdaysShort() | O valor de retorno contém o nome abreviado de cada dia, começando por "Dom". | [ "Dom", "Seg", "Ter", "Qua", "Qui", "Sex", "Sáb" ] |
| Clock.AmPm() | Esse idioma usa um relógio de 12 horas. O valor de retorno contém as versões em letras maiúsculas das designações completas AM e PM. | [ "AM", "PM" ] |
| Clock.AmPmShort() | Esse idioma usa um relógio de 12 horas. O valor de retorno contém as versões em letras maiúsculas das designações abreviadas de AM e PM. | [ "A", "P" ] |
| Clock.IsClock24() | Esse idioma usa um relógio de 12 horas. | false |