Enquadrar um rótulo de controle de edição à direita oferece novas possibilidades de personalização.
Na versão 26, é possível enquadrar uma etiqueta de entrada à direita contra a zona de entrada.
Esta apresentação é particularmente adequada para interfaces de usuário multilíngues, cujo comprimento do rótulo dependerá do idioma: evita "buracos" entre o rótulo e a área de entrada.
Essa possibilidade está disponível para controles de caixa de combinação.
Gera um texto "Lorem ipsum" para, por exemplo, preencher temporariamente um controle com texto.
Exemplo
// Preencher um controle de edição com um texto "Lorem ipsum" de 200 palavras // que será exibido na contracapa de um livro
// Gerar o texto de 200 palavras sCoverText is string = GenerateLorem ( 200 )
// Exibir texto em o controle de edição EDT_ cover = sCoverText
Sintaxe
<Result> = GenerateLorem (<Número de palavras> [, <Semente>])
<Result>: Cadeia de caracteres
Texto gerado.
String vazia ("") se o número de palavras especificado for 0.
<Número de palavras>: Inteiro
Número de palavras a serem geradas. Se este número for 0, o texto retornado será uma string vazia ("").
<Semente>: Inteiro
Usado para alterar o texto gerado. Para cada valor deste parâmetro, um texto único é gerado. Se este parâmetro não for especificado, o texto gerado será diferente cada vez que a função for chamada.
Converte um DateTime em string no formato especificado.
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"
/ / 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.
