4D v14.3

GET SYSTEM FORMAT

Página Inicial

 
4D v14.3
GET SYSTEM FORMAT

GET SYSTEM FORMAT 


 

GET SYSTEM FORMAT ( formato ; valor ) 
Parâmetro Tipo   Descrição
formato  Inteiro longo in Formato de sistema a recuperar
valor  cadeia in Formato de sistema a recuperar

O comando GET SYSTEM FORMAT devolve o valor atual de vários parâmetros regionais definidos no sistema operativo. Este comando pode utilizar-se para criar formatos personalizados “automáticos” baseados nas preferências do sistema.

No parâmetro formato, passe o tipo do parâmetro do qual queira conhecer o valor. O resultado é devolvido diretamente pelo sistema no parâmetro valor como uma cadeia de caracteres. Em formato, deve passar uma das seguintes constantes do tema Formato de sistema . Esta é a descrição destas constantes:

Constante Tipo Valor Comentário
Currency symbol Inteiro longo 2 Símbolo de moeda (ex.: “$”)
Date separator Inteiro longo 13 Separador utilizado em formatos de data (ex.: “/”)
Decimal separator Inteiro longo 0 Separador decimal (ex.: “.”)
Short date day position Inteiro longo 15 Posição de dia no formato de data curto: “1” = esquerda, “2” = no meio, “3” = à direita
Short date month position Inteiro longo 16 Posição do mês em formato de data curta: “1” = esquerda, “2” = no meio, “3” = à direita
Short date year position Inteiro longo 17 Posição do ano em formato de data curta: “1” = esquerda, “2” = no meio, “3” = à direita
System date long pattern Inteiro longo 8 Formato de saída de data longa “dddd MMMM yyyy”
System date medium pattern Inteiro longo 7 Formato de saída de data média na forma “dddd MMMM yyyy”
System date short pattern Inteiro longo 6 Formato de saída de data curta na forma “dddd MMMM yyyy”
System time AM label Inteiro longo 18 Etiqueta adicional para uma hora antes de meio dia em formatos de 12 horas (ex.: “Manhã”)
System time long pattern Inteiro longo 5 Formato de saída de hora longa na forma “HH:MM:SS”
System time medium pattern Inteiro longo 4 Formato de saída de hora média na forma “HH:MM:SS”
System time PM label Inteiro longo 19 Etiqueta adicional para uma hora logo do meio dia em formatos de 12 horas (ex.: “Tarde”)
System time short pattern Inteiro longo 3 Formato de saída de hora curta em forma “HH:MM:SS”
Thousand separator Inteiro longo 1 Separador de milhares (ex.: “,”)
Time separator Inteiro longo 14 Separador utilizado em formatos de hora (ex.: “:”)

Exemplo  

Em um cheque que se enche mecanicamente, as sumas escritas geralmente estão precedidas de “*” com o fim de evitar fraudes. Se o formato de saída do sistema estandarte para a moeda é “$ 5,422.33”, o formato dos cheques deve ser do tipo “$***5432.33”: sem uma vírgula depois do milhar e sem espaço entre o símbolo $ e o primeiro número. O formato a utilizar com a função String deve ser “$*******.**”. Para construir-lo por programação é necessário conhecer o símbolo monetário e o separador decimal:

 GET SYSTEM FORMAT(Currency symbol;$vActSim)
 GET SYSTEM FORMAT(Decimal separator;$vDecSep)
 $MeuFormato:="###"+$vActSim+"*******"+$vDecSep+"**"
 $Result:=String(quantidade;$MeuFormato)

 
PROPRIEDADES 

Produto: 4D
Tema: Ambiente de Sistema
Número 994

 
HISTÓRIA 

Criado por: 4D v11 SQL

 
VER TAMBÉM 

OBJECT SET FORMAT

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)