Dica: O valor de retorno desta função não deve ser atribuído a um controle de edição "Data" (com uma máscara de entrada incluindo a data e hora) que espera uma string sem separadores (por exemplo: "202004281500").

Exemplo

Res = DateTimeToString ( "201912251715" ) // Res = "25/12/2019 17: 15: 00: 00"
 
Res = DateTimeToString ( RealToDateTime ( 73773 , 5 )) // Res = "25/12/2001 00:00 : 00: 00 "
 
DateTimeToString ( " " ) // Returns" "
 
Res = DateTimeToString ( " 201912251715 " , " MM-DD-YYYY HH: mm AP " ) // Res =" 12-25-2019 17:15 "
 
Res = DateTimeToString ( "201912251715" , ...
"Dia # DD do mês # MM, AAAA em HH e mm minutos" )
 
Res = DateTimeToString ( SysDateTime (), maskDateSystem )
// Res usa o formato definido no projeto
 
// O caso é usado para os dias e para os meses depende das opções linguísticas do projeto
Res = DateTimeToString ( "202012021715" , "DDD MMM D AAAA HH: mm AP" )
// Res = "Quarta, 2 de dezembro de 2020 17:15"
 
Res = DateTimeToString ( "202012021715" , "DDDD MMMM D AAAA HH: mm AP" )
// Res = "Quarta-feira,2 de dezembro de 2020, 17:15 "
 
// Você pode forçar o uso de letras maiúsculas para dias e meses
Res = DateTimeToString ( "202012021715" , "Ddd Mmm D AAAA HH: mm AP" )
// Res = "Wed Dec 2 2020 17:15"
Res = DateTimeToString ( "202012021715" , "Dddd Mmmm D AAAA HH: mm AP" )
// Res = "Quarta-feira, 2 de dezembro de 2020 17:15"
 
Res = DateTimeToString ( "201911251715" , maskDateEmail )
// Returns "Seg, 25 de novembro de 2019 17 : 15: 00 +0100 "
 
Res = DateTimeToString ( "201908251715" ,maskDateEmail )  
// Returns "Sun, 25 Aug 2019 17:15:00 +0200"
 
Res = DateTimeToString ( "201911250015" , maskDateEmailUTC )
// Returns "Sun, 24 Nov 2019 23:15:00 +0000"
 
Res = DateTimeToString ( "201908251715" , maskDateInternet )  
// Retorna "2019-08-25T17: 15: 00.000 + 02: 00"
 
Res = DateTimeToString ( "201908250015" , maskDateInternetUTC )  
// Retorna "2019-08-24T22: 15: 00.000Z"
 
/ / Em 02/09/2020 às 11:00 AM
Res = DateTimeToString( "202001011715" , maskDateRelativeDuration )
// Retorna: 8 meses atrás
 
Res = DateTimeToString ( "202011251715" , maskDateRelativeDuration )
// Retorna: próximo ano
 
Res = DateTimeToString ( "202001181715" , maskDateRelativeDuration )
// Retorna: em 6 horas

Sintaxe

<Result> = DateTimeToString (<Dados a serem convertidos> [, <Format>])

<Result>: Cadeia de caracteres

Sequência de caracteres no formato especificado.

<Dados a serem convertidos>: string de caracteres (com aspas) ou variável DateTime

Data e hora local para conversão. Pode corresponder a:
uma variável DateTime.
uma sequência de caracteres com um dos seguintes formatos:
AAAAMMDDHHmmSSCCC
AAAAMMDDHHmmSSCC
AAAAMMDDHHmmSS
AAAAMMDDHHmm
AAAAMMDDHH
AAAAMMDD
Este parâmetro será considerado inválido nos seguintes casos:
se a data for inválida ou anterior a 01/01/1970. Você pode verificar a validade de uma data usando DateValid .
se a hora for inválida. Você pode verificar a validade de um tempo usando TimeValid .
Observação: É possível usar datas posteriores a 2038.

<Formato>: Cadeia de caracteres opcional

Formato da data e hora convertidas. Este parâmetro pode conter uma palavra, uma frase, ... Os caracteres que representam os diferentes elementos da data e hora serão substituídos automaticamente pelo valor no parâmetro <Data para converter>. Nesta string:
YYYY representa um ano de 4 dígitos,
YY representa um ano de 2 dígitos,
M representa o mês sem um zero à esquerda,
MM representa um mês de 2 dígitos,
MMM representa um mês de 3 letras (por exemplo, janeiro). O caso usado depende das opções linguísticas do projeto.
Mmm representa um mês de 3 letras com a primeira letra maiúscula (por exemplo, janeiro)
mmm representa um mês de 3 letras com a primeira letra em minúsculas (por exemplo, jan)
MMMM representa o mês como um nome completo (por exemplo, janeiro). O caso usado depende das opções linguísticas do projeto.
Mmmm representa o mês como um nome completo com a primeira letra em maiúscula (por exemplo, janeiro)
mmmm representa o mês como um nome completo com a primeira letra em minúsculas (por exemplo, janeiro)
D representa o dia sem um zero à esquerda,
DD representa um dia de 2 dígitos,
DDD representa um dia de 3 letras (por exemplo, seg). O caso usado depende das opções linguísticas do projeto.
Ddd representa um dia de 3 letras com a primeira letra maiúscula (por exemplo, seg)
ddd representa um dia de 3 letras com a primeira letra em minúsculas (por exemplo, mon)
DDDD representa o dia como um nome completo (por exemplo, segunda-feira). O caso usado depende das opções linguísticas do projeto.
Dddd representa o dia como um nome completo com a primeira letra em maiúsculas (por exemplo, segunda-feira)
dddd representa o dia como um nome completo com a primeira letra em minúsculas (por exemplo, segunda-feira)
M representa a primeira letra do dia (por exemplo, M, T, W, T, F, S, S)
HH representa o número de horas,
mm representa o número de minutos,
SS representa o número de segundos,
CC representa o número de centésimos de segundo,
CCC representa o número de milésimos de segundo,
AP representa "AM" ou "PM" (se "AP" for usado, a hora é exibida no formato de 12 horas).
Se este parâmetro corresponder à constante:
maskDateRelativeDuration Este formato é usado para expressar o tempo decorrido (ou que irá decorrer) entre a data e hora atual e a data e hora especificada. Este formato é expresso em linguagem natural. As diferentes formulações utilizadas podem ser configuradas na descrição do projeto para o idioma atual:
No painel "Projeto", no grupo "Projeto", clique em "Descrição".
Na guia "Idiomas":
selecione o idioma a ser configurado.
selecione a guia "Data".
Clique no botão "Datas e horários em linguagem natural".
Defina (se necessário) as legendas personalizadas a serem usadas. Essas legendas serão usadas:
para o resultado de DateTimeToString .
para os controles que usam a máscara de exibição "Duração relativa".
Não disponível.
maskDateEmail O formato usado corresponde ao formato de data e hora do padrão RFC-5322 usado para criptografar e-mails, feeds RSS, etc, ...
O resultado é expresso no fuso horário local.
Não disponível.
maskDateEmailUTC O formato usado corresponde ao formato de data e hora do padrão RFC-5322 usado para criptografar e-mails, feeds RSS, etc, ...
O resultado é expresso em hora universal (UTC).
Não disponível.
maskDateInternet O formato usado corresponde ao formato de data e hora do padrão RFC-3339 usado para comunicações internacionais.
O resultado é expresso no fuso horário local.
maskDateInternetUTC O formato usado corresponde ao formato de data e hora do padrão RFC-3339 usado para comunicações internacionais.
O resultado é expresso em hora universal (UTC).
Não disponível.
maskDateSystem O formato utilizado corresponde ao formato definido na descrição do projeto para o idioma atual:
No painel "Projeto", no grupo "Projeto", clique em "Descrição".
Selecione a guia "Idiomas" e, em seguida, a guia "Data".
O formato de data usado corresponde a:
as configurações do sistema operacional,
os parâmetros especificados (com os dias e meses definidos).
Selecione a guia "Idiomas" e, em seguida, a guia "Horário".
O formato de hora usado corresponde a:
as configurações do sistema operacional,
os parâmetros especificados (com os dias e meses definidos).

Se este parâmetro não for especificado, o formato DD / MM / AAAA HH: mm: SS: CC é usado por padrão.

Observações

Validade da data e hora

A validade da data e hora passadas como parâmetros é verificada. Uma mensagem de erro fatal é exibida se a data e hora for inválida. Você pode verificar a validade de uma data e hora usando DateTimeValid . O formato de armazenamento de data e hora permite que você armazene as horas entre 01/01/0001 00:00:00 e 31/12/9999 11: 59: 59: 99 PM.

As funções e propriedades WLanguage fazem cálculos precisos em datas e horas de 1 de janeiro de 1583 00: 00: 00: 00.

Formato de data e hora

DateTimeToString é usado para formatar uma data e hora retornada por RealToDateTime ou SysDateTime . O resultado pode ser atribuído a um controle de texto, por exemplo.

Para obter a data e hora em outro formato, você deve usar as seguintes funções: Direita, Esquerda, Meio, etc.

Caso especial: <Formato> não é especificado

As opções de idioma especificadas para datas e horas na descrição do projeto são usadas se nenhum formato específico for definido.

Para exibir as opções linguísticas do projeto:

Abra a descrição do projeto: no painel "Projeto", no grupo "Projeto", clique em "Descrição".
Selecione a guia "Idioma".

Por exemplo:

se o projeto usar as opções linguísticas do Windows para as datas, os dias da semana e os meses começarão com um caractere maiúsculo em um computador com Windows em inglês.
se o projeto usa parâmetros específicos para as datas para um ou mais idiomas (nome personalizado do dia ou mês, etc.), esses parâmetros serão levados em consideração para o idioma especificado.

Páginas

quinta-feira, 17 de dezembro de 2020

DICAS 3215 - WINDEV WEBDEV MOBILE - 26 e 25 - NOVIDADES 19 - DateTimeToString - Converte um DateTime em string

https://youtu.be/aednqXwwGRU

Esse Video Ao Vivo vai estrear as 08:30 do dia 17/12/2020

Atualizar Versao 26 windev webdev mobile

Teste

Marcadores


maskDateRelativeDuration	Este formato é usado para expressar o tempo decorrido (ou que irá decorrer) entre a data e hora atual e a data e hora especificada. Este formato é expresso em linguagem natural. As diferentes formulações utilizadas podem ser configuradas na descrição do projeto para o idioma atual: No painel "Projeto", no grupo "Projeto", clique em "Descrição". Na guia "Idiomas": selecione o idioma a ser configurado. selecione a guia "Data". Clique no botão "Datas e horários em linguagem natural". Defina (se necessário) as legendas personalizadas a serem usadas. Essas legendas serão usadas: para o resultado de DateTimeToString . para os controles que usam a máscara de exibição "Duração relativa". Não disponível.
maskDateEmail	O formato usado corresponde ao formato de data e hora do padrão RFC-5322 usado para criptografar e-mails, feeds RSS, etc, ... O resultado é expresso no fuso horário local. Não disponível.
maskDateEmailUTC	O formato usado corresponde ao formato de data e hora do padrão RFC-5322 usado para criptografar e-mails, feeds RSS, etc, ... O resultado é expresso em hora universal (UTC). Não disponível.
maskDateInternet	O formato usado corresponde ao formato de data e hora do padrão RFC-3339 usado para comunicações internacionais. O resultado é expresso no fuso horário local.
maskDateInternetUTC	O formato usado corresponde ao formato de data e hora do padrão RFC-3339 usado para comunicações internacionais. O resultado é expresso em hora universal (UTC). Não disponível.
maskDateSystem	O formato utilizado corresponde ao formato definido na descrição do projeto para o idioma atual: No painel "Projeto", no grupo "Projeto", clique em "Descrição". Selecione a guia "Idiomas" e, em seguida, a guia "Data". O formato de data usado corresponde a: as configurações do sistema operacional, os parâmetros especificados (com os dias e meses definidos). Selecione a guia "Idiomas" e, em seguida, a guia "Horário". O formato de hora usado corresponde a: as configurações do sistema operacional, os parâmetros especificados (com os dias e meses definidos).