|
ÉpocaOs valores de data e de hora possuem uma origem ou época associada, que é o momento a partir do qual os eventos começam. Qualquer valor de data e de hora anterior a essa época é inválido.
A unidade de valor para todas as funções de data é o número de dias desde a época. A unidade de valor para todas as funções de hora é o número de milissegundos desde a época.
O Designer define o dia 1 para o período referente a todas as funções de data como 1 de janeiro de 1900 e o milissegundo 1 para o período referente a todas as funções de hora como meia-noite, 00:00:00 (GMT). Essa definição significa que valores de hora negativos podem ser retornados aos usuários em fusos horários ao leste do GMT.
Formatos de dataUm formato de data é uma especificação simplificada de como uma data é exibida. Ele consiste em vários sinais de pontuação e símbolos que representam a formatação que a data deve usar. A tabela a seguir lista exemplos de formatos de data.
Formato de data
|
Exemplo
|
|---|
MM/DD/YY
|
11/11/78
|
DD/MM/YY
|
25/07/85
|
MMMM DD, YYYY
|
10.03.64
|
O formato de data é estabelecido pelo padrão ISO. Cada país ou região especifica seus próprios formatos de data. As quatro categorias gerais de formatos de data são: abreviado, médio, longo e completo. A tabela a seguir contém alguns exemplos dos diferentes formatos de data de diferentes locais para cada uma das categorias.
Identificador de localidade e descrição
|
Formato de data (Categoria)
|
Exemplo
|
|---|
en_GB
Inglês (Reino Unido)
|
MM/DD/YY (Abreviado)
|
08/12/92
08/04/05
|
fr_CA
Francês (Canadá)
|
YY-MM-DD (Médio)
|
92-08-18
|
de_DE
Alemão (Alemanha)
|
D. MMMM YYYY (Longo)
|
17. Jun 1989
|
fr_FR
Francês (França)
|
EEEE, ' le ' D MMMM YYYY (Completo)
|
Lundi, le 29 Octobre, 1990
|
Formatos de horaUm formato de hora é uma especificação simplificada de como formatar uma hora. Ele consiste em pontuações, letras e símbolos de padrões. A tabela a seguir lista exemplos de formatos de hora.
Formato de hora
|
Exemplo
|
|---|
h:MM A
|
7:15 PM
|
HH:MM:SS
|
21:35:26
|
HH:MM:SS 'o''clock' A Z
|
14:20:10 o'clock PM EDT
|
Formatos de hora são estabelecidos pelo padrão ISO. Cada nação especifica seu formato de hora padrão, abreviado, médio, longo e completo. A localidade identifica o formato das horas em conformidade com os padrões de uma nação específica.
A tabela a seguir contém alguns exemplos dos diferentes formatos de data de diferentes locais para cada uma das categorias.
Identificador de localidade e descrição
|
Formato de hora (Categoria)
|
Exemplo
|
|---|
en_GB
Inglês (Reino Unido)
|
HH:MM (Abreviado)
|
14:13
|
fr_CA
Francês (Canadá)
|
HH:MM:SS (Médio)
|
12:15:50
|
de_DE
Alemão (Alemanha)
|
HH:MM:SS z (Longo)
|
14:13:13 -0400
|
fr_FR
Francês (França)
|
HH ' h ' MM Z (Completo)
|
14 h 13 GMT-04:00
|
Formatos de imagem de data e horaOs símbolos a seguir devem ser usados para criar padrões de data e de hora para os campos de data/hora. Alguns símbolos de dados apenas são usados em localidades referentes aos idiomas chinês, japonês e coreano. Esses símbolos também estão especificados a seguir.
Nota: A vírgula (,), o hífen (-), os dois pontos (:), a barra (/), o ponto final (.) e o espaço ( ) são tratados como valores literais e podem ser incluídos em qualquer local de um padrão. Para incluir uma expressão em um padrão, delimite a string de texto com aspas simples ('). Por exemplo, 'Seu pagamento deverá ser feito até' MM-DD-YY pode ser especificado como o padrão de exibição.
Símbolo de data
|
Descrição
|
Valor formatado para a localidade Inglês (EUA), em que o valor de entrada que considera a localidade é 1/1/08 (ou seja, 1º de janeiro de 2008)
|
|---|
D
|
Dia do mês com 1 ou 2 dígitos (de 1 a 31)
|
1
|
DD
|
Dia do mês com 2 dígitos e 0 incluído (de 01 a 31)
|
01
|
J
|
Dia do ano com 1, 2 ou 3 dígitos (de 1 a 366)
|
1
|
JJJ
|
Dia do ano com 3 dígitos e 0 incluído (de 001 a 366)
|
001
|
M
|
Mês do ano com 1 ou 2 dígitos (de 1 a 12)
|
1
|
MM
|
Mês do ano com 2 dígitos e 0 incluído (de 01 a 12)
|
01
|
MMM
|
Nome de mês abreviado
|
Jan
|
MMMM
|
Nome do mês completo
|
Janeiro
|
E
|
Dia da semana com 1 dígito (de 1 a 7), em que (1=Domingo)
|
3 (porque 1º de janeiro de 2008 é uma terça-feira)
|
EEE
|
Nome do dia da semana abreviado
|
Ter (porque 1º de janeiro de 2008 é uma terça-feira)
|
EEEE
|
Nome do dia da semana completo
|
Terça-feira (porque 1º de janeiro de 2008 é uma terça-feira)
|
YY
|
Ano com 2 dígitos, em que os números menores que 30 são considerados para inclusão após o ano 2000 e os números a partir de 30 são considerados para inclusão antes de 2000. Por exemplo, 00=2000, 29=2029, 30=1930 e 99=1999
|
08
|
YYYY
|
Ano com 4 dígitos
|
2008
|
G
|
Nome da era (AC ou DC)
|
DC
|
w
|
Semana do mês com 1 dígito (de 0 a 5), em que a semana 1 corresponde ao primeiro conjunto de quatro dias consecutivos terminando em um sábado
|
1
|
WW
|
Semana do ano com 2 dígitos (de 01 a 53) ISO-8601, em que a semana 1 é a semana que contém o dia 4 de janeiro
|
01
|
Estão disponíveis vários padrões de data adicionais que podem ser especificados para localidades nos idiomas chinês, japonês e coreano.
Eras japonesas podem ser representadas por vários símbolos diferentes. Os quatro símbolos finais de era fornecem símbolos alternativos para representar eras japonesas.
Símbolo de data CJK
|
Descrição
|
|---|
DDD
|
O dia do mês da localidade, com cálculos numéricos simbólicos
|
DDDD
|
O dia do mês da localidade, com cálculos numéricos simbólicos de acordo com a regra de dígitos 10
|
YYY
|
O ano da localidade, com cálculos numéricos simbólicos
|
YYYYY
|
O ano da localidade, com cálculos numéricos simbólicos de acordo com a regra de dígitos 10
|
g
|
O nome alternativo da era para a localidade. No caso da era japonesa atual (Heisei), esse padrão exibe a letra H no formato ASCII (U+48).
|
gg
|
O nome alternativo da era para a localidade. No caso da era japonesa atual, esse padrão exibe o ideograma que é representado pelo símbolo Unicode (U+5E73).
|
ggg
|
O nome alternativo da era para a localidade. No caso da era japonesa atual, esse padrão exibe os ideogramas que são representados pelos símbolos Unicode (U+5E73 U+6210).
|
g
|
O nome alternativo da era para a localidade. No caso da era japonesa atual, esse padrão exibe a letra H de largura total (U+FF28)
|
g g
|
O nome alternativo da era para a localidade. No caso da era japonesa atual, esse padrão exibe o ideograma que é representado pelo símbolo Unicode (U+337B).
|
Símbolo de hora
|
Descrição
|
Valor de entrada que considera a localidade
|
Valor formatado para a localidade Inglês (EUA)
|
|---|
h
|
Hora do dia com 1 ou 2 dígitos (de 1 a 12) (AM/PM)
|
12:08 AM ou 2:08 PM
|
12 ou 2
|
hh
|
Hora do dia com 2 dígitos e 0 incluído (de 01 a 12) (AM/PM)
|
12:08 AM ou 2:08 PM
|
12 or 02
|
k
|
Hora do dia com 1 ou 2 dígitos (de 0 a 11) (AM/PM)
|
12:08 AM ou 2:08 PM
|
0 ou 2
|
kk
|
Hora do dia com 2 dígitos (de 00 a 11) (AM/PM)
|
12:08 AM ou 2:08 PM
|
00 or 02
|
H
|
Hora do dia com 1 ou 2 dígitos (de 0 a 23)
|
12:08 AM ou 2:08 PM
|
0 ou 14
|
HH
|
Hora do dia com 2 dígitos e 0 incluído (de 00 a 23)
|
12:08 AM ou 2:08 PM
|
00 or 14
|
K
|
Hora do dia com 1 ou 2 dígitos (de 0 a 24)
|
12:08 AM ou 2:08 PM
|
24 ou 14
|
KK
|
Hora do dia com 2 dígitos e 0 incluído (de 01 a 24)
|
12:08 AM ou 2:08 PM
|
24 ou 14
|
M
|
Minuto da hora com 1 ou 2 dígitos (de 0 a 59)
Nota: Use este símbolo com um símbolo de hora.
|
2:08 PM
|
8
|
MM
|
Minuto da hora com 2 dígitos e 0 incluído (de 00 a 59)
Nota: Use este símbolo com um símbolo de hora.
|
2:08 PM
|
08
|
S
|
Segundo do minuto com 1 ou 2 dígitos (de 0 a 59)
Nota: Use este símbolo com um símbolo de hora e minuto.
|
2:08:09 PM
|
9
|
SS
|
Segundo do minuto com 2 dígitos e 0 incluído (de 00 a 59)
Nota: Use este símbolo com um símbolo de hora e minuto.
|
2:08:09 PM
|
09
|
FFF
|
Centésimo de segundo com 3 dígitos (de 000 a 999)
Nota: Use este símbolo com um símbolo de hora, minuto e segundo.
|
2:08:09 PM
|
09
|
A
|
A parte do dia que vai da meia-noite ao meio-dia (AM) ou do meio-dia à meia-noite (PM)
|
2:08:09 PM
|
PM
|
z
|
Formato de fuso horário ISO-8601 (por exemplo, Z, +0500, -0030, -01, +0100)
Nota: Use este símbolo com um símbolo de hora.
|
2:08:09 PM
|
-0400
|
zz
|
Formato alternativo de fuso horário ISO-8601 (por exemplo, Z, +05:00, -00:30, -01, 01:00)
Nota: Use este símbolo com um símbolo de hora.
|
2:08:09 PM
|
-04:00
|
Z
|
Nome abreviado do fuso horário (por exemplo, GMT, GMT+05:00, GMT-00:30, EST, PDT)
Nota: Use este símbolo com um símbolo de hora.
|
2:08:09 PM
|
EDT
|
Símbolos reservadosOs seguintes símbolos apresentam significados especiais e não podem ser usados como texto literal.
Símbolo
|
Descrição
|
|---|
?
|
Quando submetido, o símbolo corresponde a qualquer outro caractere. Quando unido para exibição, ele se torna um espaço.
|
*
|
Quando submetido, o símbolo corresponde a 0 ou a caracteres de espaço em branco Unicode. Quando unido para exibição, ele se torna um espaço.
|
+
|
Quando submetido, o símbolo corresponde a um ou mais caracteres de espaço em branco Unicode. Quando unido para exibição, ele se torna um espaço.
|
LocalidadesUma localidade é um termo padrão usado ao desenvolver padrões internacionais para identificar uma nação específica (idioma, país ou região). Para fins de FormCalc, um local define o formato de datas, horas, números e valores monetários relevante para uma nação ou região específica para que os usuários possam usar os formatos com os quais estão acostumados.
Cada localidade é formada por uma string exclusiva de caracteres, chamada de identificador de localidade. A composição dessas strings é controlada pela ISO (International Standards Organization) IETF (Internet Engineering Task Force), um grupo de trabalho da Internet Society (www.isoc.org).
Os identificadores de localidade consistem em uma parte de idioma, uma parte de país ou região ou ambos. A tabela a seguir lista as localidades válidas para esta versão do Designer.
Linguagem
|
País ou região
|
Código ISO
|
|---|
Arábico
|
Algéria
|
ar_DZ
|
Arábico
|
Bahrain
|
ar_BH
|
Arábico
|
Egito
|
ar_EG
|
Arábico
|
Iraque
|
ar_IQ
|
Arábico
|
Jordânia
|
ar_JO
|
Arábico
|
Kuwait
|
ar_KW
|
Arábico
|
Líbano
|
ar_LB
|
Arábico
|
Líbia
|
ar_LY
|
Arábico
|
Marrocos
|
ar_MA
|
Arábico
|
Oman
|
ar_OM
|
Arábico
|
Qatar
|
ar_QA
|
Arábico
|
Arábia Saudita
|
ar_SA
|
Arábico
|
Sudão
|
ar_SD
|
Arábico
|
Síria
|
ar_SY
|
Arábico
|
Tunísia
|
ar_TN
|
Arábico
|
Emirados Árabes Unidos
|
ar_AE
|
Arábico
|
Iêmen
|
ar_YE
|
Armênio
|
Armênia
|
hy_AM
|
Azerbaijano – Cirílico
|
Azerbaijão
|
az_Cyrl_AZ
|
Azerbaijano – Latim
|
Azerbaijão
|
az_Latn_AZ
|
Basco
|
Espanha
|
eu_ES
|
Bósnio
|
Bósnia e Herzegovina
|
bs_BA
|
Búlgaro
|
Bulgária
|
bg_BG
|
Catalão
|
Espanha
|
ca_ES
|
Chinês
|
República Popular da China (simplificado)
|
zh_CN
|
Chinês
|
Hong Kong (RAE), China
|
zh_HK
|
Chinês
|
Taiwan (tradicional)
|
zh_TW
|
Croata
|
Croácia
|
hr_HR
|
Tcheco
|
República Tcheca
|
cs_CZ
|
Dinamarquês
|
Dinamarca
|
da_DK
|
Holandês
|
Bélgica
|
nl_BE
|
Holandês
|
Holanda
|
nl_NL
|
Inglês
|
Austrália
|
en_AU
|
Inglês
|
Bélgica
|
en_BE
|
Inglês
|
Canadá
|
en_CA
|
Inglês
|
Hong Kong (RAE), China
|
en_HK
|
Inglês
|
Índia
|
en_IN
|
Inglês
|
Irlanda
|
en_IE
|
Inglês
|
Nova Zelândia
|
en_NZ
|
Inglês
|
Filipinas
|
en_PH
|
Inglês
|
Cingapura
|
en_SG
|
Inglês
|
África do Sul
|
en_ZA
|
Inglês
|
Reino Unido
|
en_GB
|
Inglês
|
Reino Unido (Europa)
|
en_GB_EURO
|
Inglês
|
Estados Unidos da América
|
en_US
|
Inglês
|
Ilhas Virgens Norte-Americanas
|
en_VI
|
Estônio
|
Estônia
|
et_EE
|
Finlandês
|
Finlândia
|
fi_FI
|
Francês
|
Bélgica
|
fr_BE
|
Francês
|
Canadá
|
fr_CA
|
Francês
|
França
|
fr_FR
|
Francês
|
Luxemburgo
|
fr_LU
|
Francês
|
Suíça
|
fr_CH
|
Alemão
|
Áustria
|
de_AT
|
Alemão
|
Alemanha
|
de_DE
|
Alemão
|
Luxemburgo
|
de_LU
|
Alemão
|
Suíça
|
de_CH
|
Grego
|
Grécia
|
el_GR
|
Hebraico
|
Israel
|
he_IL
|
Húngaro
|
Hungria
|
hu_HU
|
Indonês
|
Indonésia
|
id_ID
|
Italiano
|
Itália
|
it_IT
|
Italiano
|
Suíça
|
it_CH
|
Japonês
|
Japão
|
ja_JP
|
Cazaque
|
Cazaquistão
|
kk_KZ
|
Khmer
|
Camboja
|
km_KH
|
Coreano
|
Coreia
|
ko_KR
|
Coreano
|
Coreia (Hanja)
|
ko_KR_HANI
|
Lao
|
Laos
|
lo_LA
|
Letão
|
Letônia
|
lv_LV
|
Lituano
|
Lituânia
|
lt_LT
|
Malaio
|
Malásia
|
ms_MY
|
Norueguês (Bokmal)
|
Noruega
|
nb_NO
|
Norueguês (Nynorsk)
|
Noruega
|
nn_NO
|
Persa
|
Irã
|
fa_IR
|
Polaco
|
Polônia
|
pl_PL
|
Português
|
Brasil
|
pt_BR
|
Português
|
Portugal
|
pt_PT
|
Romeno
|
Romênia
|
ro_RO
|
Russo
|
Rússia
|
ru_RU
|
Sérvio – Cirílico
|
Sérvia e Montenegro
|
sr_Cyrl_CS
|
Sérvio - Latim
|
Sérvia e Montenegro
|
sr_Latn_CS
|
Eslovaco
|
Eslováquia
|
sk_SK
|
Esloveno
|
Eslovênia
|
sl_SI
|
Espanhol
|
Argentina
|
es_AR
|
Espanhol
|
Bolívia
|
es_BO
|
Espanhol
|
Chile
|
es_CL
|
Espanhol
|
Colômbia
|
es_CO
|
Espanhol
|
Costa Rica
|
es_CR
|
Espanhol
|
República Dominicana
|
es_DO
|
Espanhol
|
Equador
|
es_EC
|
Espanhol
|
El Salvador
|
es_SV
|
Espanhol
|
Guatemala
|
es_GT
|
Espanhol
|
Honduras
|
es_HN
|
Espanhol
|
México
|
es_MX
|
Espanhol
|
Nicarágua
|
es_NI
|
Espanhol
|
Panamá
|
es_PA
|
Espanhol
|
Paraguai
|
es_PY
|
Espanhol
|
Peru
|
es_PE
|
Espanhol
|
Porto Rico
|
es_PR
|
Espanhol
|
Espanha
|
es_ES
|
Espanhol
|
Estados Unidos da América
|
es_US
|
Espanhol
|
Uruguai
|
es_UY
|
Espanhol
|
Venezuela
|
es_VE
|
Sueco
|
Suécia
|
sv_SE
|
Tagalo
|
Filipinas
|
tl_PH
|
Tailandês
|
Tailândia
|
th_TH
|
Tailandês
|
Tailândia (Tradicional)
|
th_TH_TH
|
Turco
|
Turquia
|
tr_TR
|
Ucraniano
|
Ucrânia
|
uk_UA
|
Vietnamita
|
Vietnã
|
vi_VN
|
Geralmente, os dois elementos do local são importantes. Por exemplo, os nomes dos dias da semana e dos meses em inglês do Canadá e do Reino Unido têm formatos idênticos, mas as datas têm formatos diferentes. Portanto, não basta especificar a localidade do idioma inglês. Além disso, não basta especificar apenas um país como a localidade. Por exemplo, o Canadá possui diferentes formatos de data para os idiomas inglês e francês.
Em geral, cada aplicativo opera em um ambiente em que uma localidade está presente. Essa localidade é conhecida como localidade de ambiente. Em alguns casos, um aplicativo pode operar em um sistema, ou em um ambiente, no qual uma localidade não está presente. Nesses casos raros, a localidade de ambiente é definida para o padrão Inglês dos Estados Unidos (en_US). Essa localidade é conhecida como localidade padrão.
|
|
|
