Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
4D v19
4D View Pro Zellenformat

4D View Pro Zellenformat  


 

 

Die Vorgabe bestimmter Formate stellt sicher, dass der Inhalt Ihrer 4D View Pro Dokumente in gewünschter Form angezeigt wird. 4D View Pro hat vorgegebene Formate für Zahlen, Datum, Zeit und Text. Sie können aber genauso mit spezifischen Zeichen und Code eigene Vorgaben zum Formatieren von Zelleninhalt erstellen.

Verwenden Sie z.B. den Befehl VP SET VALUE oder VP SET NUM VALUE, um Beträge in eine Rechnung einzugeben, können Sie Währungssymbole ($, €, ¥, etc.) immer gleich ausrichten unabhängig vom Abstand zum Betrag (sei es $5.00 oder $5,000.00). Dafür verwenden Sie Formatierungszeichen und definieren das Format _($* #,##0.00_). Sie erhalten folgendes Ergebnis:

Beachten Sie, dass sich beim Erstellen eigener Formatvorlagen nur die Darstellung der Daten verändert. Der Wert der Daten bleibt unverändert.

Zahlenformate gelten für alle Zahlentypen (z.B. positiv, negativ und Nullen).

ZeichenBeschreibungBeispiel
0Platzhalter zur Anzeige von Nullen.#.00 zeigt 1.1 als 1.10 an  
.Zeigt Dezimalstellen mit Punkt als Trenner an0.00 zeigt 1999 als 1999.00 an
,Zeigt in einer Zahl Trenner für Tausender an. Tausender werden durch Komma getrennt, wenn das Format ein Komma umgeben von Nummernzeichen "#" oder Nullen enthält. Die Zahl wird in Tausendergruppen formatiert. #,0 zeigt 12200000 als 12,200,000 an
_Passt die Breite zwischen Währungssymbol und Betrag dynamisch an. Wird in der Regel mit Klammern kombiniert, um jeweils linke und rechte Einrückung zu setzen  _(und_).
@Formatierer für TextWendet das Format auf allen Text in der Zelle an
*Wiederholt das nächste Zeichen zum Ausfüllen der Spaltenbreite. 0*- fügt genug Striche nach einer Zahl an, um die Zelle zu füllen, während *0 vor der Zahl führende Nullen setzt.
" "Zeigt den Text in Anführungszeichen ohne Interpretation. "8%" erscheint als 8%
%Zeigt Zahlen als Prozent von 100. 8% erscheint als .08
#Platzhalter für Stellen ohne Anzeige von Extra Nullen. Hat eine Zahl mehr Stellen nach dem Dezimaltrenner als Platzhalter da sind, wird die Zahl aufgerundet.#.# zeigt 1.54 als 1.5 an.
?Platzhalter für Stellen, der Platz für Extra Nullen frei lässt, sie aber nicht anzeigt. Typische Verwendung ist die Ausrichtung von Zahlen nach dem Dezimaltrenner. $? richtet unterschiedliche Beträge nach dem Dollarzeichen aus.
\Zeigt das darauffolgende Zeichen an.#.00\? zeigt 123 als 123.00? an
/Bei Verwendung mit Zahlen erscheinen sie als Bruchzahlen. Bei Verwendung mit Text, Datums- oder Zeitangaben erscheinen sie als Schrägstrich.#/# zeigt .75 als 3/4
[ ]Erstellt Formate nach Bedingung.[>100][GREEN]#,##0;[<=-100][YELLOW]#,##0;[BLUE]#,##0
EFormat für wissenschaftliche Notation.#E+# - zeigt 1,500,500 als 2E+6
[color]Formatiert Text oder Zahlen in der angegebenen Farbe[#Green]###.##[Red]-###.###

  //Zellenwert als spezifisches Währungsformat setzen
 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)")

4D View Pro bietet folgende Konstanten für Datum- und Zeitformate nach ISO 8601:

Konstante Wert Kommentar
vk pattern full date time "_fullDateTimePattern_" ISO 8601 Format für ausgeschriebenes Datum und Zeit in der aktuellen Systemeinstellung
Standardmuster USA: "dddd, dd MMMM yyyy HH:mm:ss"
vk pattern long date "_longDatePattern_" ISO 8601 Format für ausgeschriebenes Datum in der aktuellen Systemeinstellung.
Standardmuster USA: "dddd, dd MMMM yyyy"
vk pattern long time "_longTimePattern_" ISO 8601 Format für die Zeit in der aktuellen Systemeinstellung.
Standardmuster USA: "HH:mm:ss"
vk pattern month day "_monthDayPattern_" ISO 8601 Format für Monat und Tag in der aktuellen Systemeinstellung.
Standardmuster USA: "MMMM dd"
vk pattern short date "_shortDatePattern_" Abgekürztes ISO 8601 Format für das Datum in der aktuellen Systemeinstellung.
Standardmuster USA: "MM/dd/yyyy"
vk pattern short time "_shortTimePattern_" Abgekürztes ISO 8601 Format für die Zeit in der aktuellen Systemeinstellung.
Standardmuster USA: "HH:mm"
vk pattern sortable date time "_sortableDateTimePattern_" ISO 8601 Format für sortierbares Datum und Zeit in der aktuellen Systemeinstellung.
Standardmuster USA: "yyyy\'-\'MM\'-\'dd\'T\'HH\':\'mm\':\'ss"
vk pattern universal sortable date time "_universalSortableDateTimePattern_" ISO 8601 Format für sortierbares Datum und Zeit in der aktuellen Systemeinstellung mit UTC.
Standardmuster USA: "yyyy\'-\'MM\'-\'dd HH\':\'mm\':\'ss\'Z\'"
vk pattern year month "_yearMonthPattern_" ISO 8601 Format für Monat und Jahr in der aktuellen Systemeinstellung.
Standardmuster USA: "yyyy MMMM"

  //Zellenwert als spezifisches Format für Datum und Zeit setzen
 VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))

Um in Ihrem System eigene Datums- oder Zeitformate zu erstellen, können Sie folgende Formate miteinander kombinieren:

Code (not case-sensitive)BeschreibungBeispiel
Datum (Januar 1, 2019)
mMonatszahl ohne führende Null1
mmMonatszahl mit führender Null 01
mmmMonatsname, kurzJan
mmmmMonatsname, langJanuar
dTageszahl ohne führende Null1
ddTageszahl mit führender Null01
dddWochentag, kurzDie
ddddWochentag, langDienstag
yyJahr, kurz19
yyyyJahr, lang2019
Zeit (2:03:05 PM)
hStunde ohne führende Null. 0-232
hhStunde mit führender Null. 00-2302
mMinuten ohne führende Null. 0-593
mmMinuten mit führender Null. 00-5903
sSekunden ohne führende Null. 0-595
ssSekunden mit führender Null. 00-5905
[h]Vergangene Zeit in Stunden14 (kann mehr als 24 sein)
[mm]Vergangene Zeit in Minuten843
[ss]Vergangene Zeit in Sekunden50585  
AM/PMTageszeit. Ohne Angabe wird das 24 Stundenfomat verwendet.PM

Hinweis: Das Format 'm' wird je nach Position im Format unterschiedlich interpretiert. Steht es direkt nach 'h' bzw. 'hh' oder direkt vor 's' bzw. 'ss', wird es als Minuten interpretiert, sonst als Monat.

Zusätzlich zu den oben beschriebenen Sonderzeichen und Codes gibt es weitere Zeichen und Symbole zur Gestaltung Ihrer Formatvorlagen. Diese benötigen nicht die Symbole \ oder "" und haben keine Auswirkung auf die Interpretation von Formaten. Sie erscheinen so, wie sie in der Vorlage dargestellt werden.

ZeichenBeschreibungBeispiel
+ and -Plus und Minuszeichen ### + ### = ###,###
( )Linke und rechte Klammer (-###.##)
:Doppelpunkt hh:mm:ss
^Caret-Zeichen #^#
'Apostroph '######
{ }Geschweifte Klammern {###,###,###}
< >Zeichen für kleiner als und größer als## >##
=Ist-gleich Zeichen #+#=##
/Schrägstrich (Bei Zahlenformaten werden diese als Bruchzahl angezeigt) mm/dd/yyyy
!Ausrufezeichen $###.00!
&kaufmännisches Und "Hallo" & "Willkommen"
~Tilde ~##
 Abstand
Euro €###.00
£Britische Pfund £###.00
¥Japanische Yen ¥###.00
$Dollarzeichen $###.00
¢Centzeichen .00¢



Siehe auch 

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

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: 4D View Pro Programmiersprache

 
SEITENINHALT 
 
GESCHICHTE 

Erstellt: 4D v17 R4

 
ARTIKELVERWENDUNG

4D View Pro Handbuch ( 4D v19)