4D View Pro Cell Format

4D v19

A definição de um modelo de formato garante que o conteúdo de seus documentos 4D View Proda maneira que quiser. 4D View Pro tem formatos integrados para números, datas, horas e texto, mas também pode criar seus próprios modelos para formatar o conteúdo das células utilizando caracteres e códigos especiais.

Por exemplo, ao utilizar os comandos VP SET VALUE ou VP SET NUM VALUE para inserir quantias em uma fatura, é possível que queira os símbolos de moeda ($, €, ¥, etc.) ) para se alinhar independentemente do espaço requerido pelo número (ou seja, se a quantidade é $5.00 ou $5,000.00). Pode utilizar os caracteres de formato e especificar o modelo _($* #,##0.00_) que mostraria as quantidades assim:

Note que criar seus próprios modelos de formato, só se modifica a visualização dos datos. O valor dos datos se mantém sem mudanças.

Formatos de número e texto

Os formatos numéricos são aplicados a todos os tipos de números (por exemplo, positivos, negativos e zeros).

Caracter	Descrição	Exemplo
0	Marcador de posição que mostra zeros.	#.00 mostrará 1.1 como 1.10
.	Mostra um ponto decimal	0.00 mostrará 1999 como 1999.00
,	Mostra o separador de milhares em um número. Os milhares estão separados por vírgulas se o formato conter uma vírgula entre os sinais numéricos "#" ou por zeros. Uma vírgula depois de um marcador de posição de dígito escala o número por 1,000.	#,0 mostrará 12200000 como 12,200,000
_	Omite a largura do seguinte caractere.	Geralmente se utiliza em combinação con parênteses para agregar indentação esquerda e direita, _ (y _) respectivamente.
@	Formatador de texto. Aplica o formato a todo o texto na célula	"[Red]@" aplica a cor de fonte vermelha para os valores de texto.
*	Repete o seguente caráctere para preencher a largura da coluna.	0- incluirá suficientes hífens depois de um número para preencher a célula, enquanto que 0 antes de todo formato incluirá zeros à esquerda.
" "	Mostra o texto dentro das aspas sem interpretação.	"8%" se mostrará como: 8%
%	Mostra números como uma porcentagem de 100.	8% se mostrará como .08
#	Marcador de posição de dígitos que não mostra zeros adicionais. Se um número tiver mais dígitos à direita do decimal que os marcadores de posição, o número se arredonda para cima.	#.# mostrará 1.54 como 1.5
?	marcador de posição de dígitos que deixa espaço para zeros adicionais, mas não os mostra. Normalmente se utiliza para alinhar números por ponto decimal.	$?? mostra um máximo de 2 decimais e faz com que os sinais de dólar se alinhem para quantidades variáveis.
\	Mostra o caractere que o segue.	#.00\? se mostrará 123 como 123.00?
/	Quando se utilizar com números, os mostra como frações. Quando se utilizar com códigos de texto, data ou hora, se mostra "tal qual".	#/# mostrará .75 como 3/4
[ ]	Cria formatos condicionais.	[>100][GREEN]#,##0;[<=-100][YELLOW]#,##0;[BLUE]#,##0
E	Formato de notação científica.	#E+# - mostrará 1,500,500 como 2E+6
[color]	Formata o texto ou o número na cor especificada	[Green]###.##[Red]-###.###

Exemplo 1

  //Estabelece o valor da célula como $125,571.35

 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)")

Formatos data e hora

4D View Pro oferece as constantes abaixo para os modelos data e hora ISO 8601:

Constante	Valor	Comentário
vk pattern full date time	"_fullDateTimePattern_"	Formato ISO 8601 para a data e hora completas na localização atual. Padrão pré-determinado de EUA: "dddd, dd MMMM yyyy HH:mm:ss"
vk pattern long date	"_longDatePattern_"	Formato ISO 8601 para a data completa na localização atual. Padrão pré-determinado de EUA .: "dddd, dd MMMM yyyy"
vk pattern long time	"_longTimePattern_"	Formato ISO 8601 para a data na localização atual. Padrão pré-determinado de EUA.: "HH:mm:ss"
vk pattern month day	"_monthDayPattern_"	Formato ISO 8601 para o mês e o dia na localização atual. Padrão pré-determinado de EUA.: "MMMM dd"
vk pattern short date	"_shortDatePattern_"	Formato abreviado ISO 8601 para a data na localização atual. Padrão pré-determinado de EUA.: "MM/dd/yyyy"
vk pattern short time	"_shortTimePattern_"	Formato abreviado ISO 8601 para a data na localização atual. Padrão pré-determinado de EUA.: "HH:mm"
vk pattern sortable date time	"_sortableDateTimePattern_"	Formato ISO 8601 para a data e hora na localização atual que pode ser ordenada. Padrão pré-determinado de EUA.: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss"
vk pattern universal sortable date time	"_universalSortableDateTimePattern_"	Formato ISO 8601 para a data e hora na localização atual utilizando UTC que pode ser ordenado. Padrão pré-determinado de EUA.: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'"
vk pattern year month	"_yearMonthPattern_"	Formato ISO 8601 para o mês e o ano na localização atual. Padrão pré-determinado de EUA.: "yyyy MMMM"

Exemplo 2

  //Estabeleça o valor de célula como data e hora específica

 VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))

Formatos personalizados de data e hora

Para criar seus modelos de data e hora, em seu local atual, pode usar combinações dos códigos abaixo:

	Código (não é sensível a miúsculas)	Descrição	Exemplo
Data			(Janeiro 1, 2019)
	m	Número mês sem um zero na frente	1
	mm	Número mês com zero na frente	01
	mmm	Nome mês, curto	Jan
	mmmm	Nome mês, longo	Janeiro
	d	Número dia sem zero na frente	1
	dd	Número dia com zero na frente	01
	ddd	dia da semana, curto	Tue
	dddd	Dia da semana, longo	Tuesday
	yy	Ano, curto	19
	yyyy	Ano, longo	2019

Hora			(2:03:05 PM)
	h	Hora sem zero na frente. 0-23	2
	hh	Hora com zero na frente. 00-23	02
	m	Minutos sem zero na frente.0-59	3
	mm	Minutos com zero na frente. 00-59	03
	s	Segundos sem zero na frente. 0-59	5
	ss	Segundos com zero na frente. 00-59	05
	[h]	Tempo passado em horas	14 (pode superar 24)
	[mm]	Tempo passado em minutos	843
	[ss]	Tempo passado em segundos	50585
	AM/PM	Períodos do dia, formato 24 horas se omitido.	PM

Nota: O código 'm' é interpretado dependendo de sua posição no modelo. Se for imediatamente depois de 'h' ou 'hh', ou imediatamente antes de 's' ou 'ss', será interpretado como minutos, senão, será interpretado como meses.

símbolos adicionais

Além dos caracteres especiais e código descritos nas sessões anteriores, há caracteres adicionais e simbolos que podem ser usados em seus modelos de formatos. Esses caracteres adicionais e símbolos não exigem um \ ou "" e não impactam a interpretação do modelo de formato. Eles aparecem "como estão" dentro do padrão.

Caractere	Descrição	Exemplo
+ e -	Sinais mais e menos	### + ### = ###,###
( )	Parêntesis esquerdo e direito	(-###.##)
:	dois pontos	hh:mm:ss
^	Acento circunflexo	#^#
'	Apóstrofe	'######
{ }	Chaves	{###,###,###}
< >	Sinais menor que e maior que	## >##
=	Sinal igual	#+#=##
/	Barra. Quando usada com números, exibe-os como frações.	mm/dd/yyyy
!	Ponto de exclamação	$###.00!
&	E comercial	"Hello" & "Welcome"
~	Til	~##
	Caractere Espaço
€	Euro	€###.00
£	Libra britânica	£###.00
¥	Yen Japonês	¥###.00
$	Sinal Dolar	$###.00
¢	Sinal Centavo	.00¢

Ver também

Number format codes in Excel
VP SET DATE TIME VALUE
VP SET DATE VALUE
VP SET FORMULA
VP SET NUM VALUE
VP SET TEXT VALUE
VP SET TIME VALUE
VP SET VALUE