User Tools

Site Tools


k9:k9.2:start

9.2 User-defined formats

Format ( Expression [ , Format ] ) AS String

The Format (..) function converts an expression into a string. You can optionally specify a user-defined format with a format string that depends on the type of expression. The format function can format numbers, currencies, dates and times.

9.2.1 General syntax

A user-defined format is described by a sequence of special characters (character string).
Characters before and after the format string are output as specified.

9.2.2 Format syntax for a numeric expression

+ 	Outputs the sign + the number 
- 	Outputs the sign - of the number; but only if the number is negative. 
# 	Returns a digit if necessary.

The number is filled with blanks on the left, so that the number of digits before the decimal point is greater than or equal to the number of # before the decimal point.

Examples:

0 	A digit is always output with a leading zero if necessary. 
. 	Outputs the decimal separator. 
,	Outputs the thousands separator. 
%	Multiplies the number by 100 and appends the % sign. 
E 	Represents the exponential part of a number. The sign of the exponent is always output.

Examples:

PRINT Format$(Pi, "-#.###") 
3.142 
PRINT Format$(Pi, "+0#.###0") 
+03.1416 
PRINT Format$(Pi / 10, "###.# %") 
31.4 % 
Print Format$(-2.3 ^ 7, "#.####E##") 
-3,405E+2

9.2.3 Format syntax for currencies

To format currencies, you can use all numeric format characters and additionally the following:

  • $ Returns the national currency sign.
  • $$ In this case, the international currency sign (short form) is output.
  • ( Symbolizes a negative currency value and must be the first character in the format string. You can specify a closing bracket) at the end of the format string.

Examples:

Print Format$(1234.56, "$$#.##") 
1234,56 EUR
Print Format$(-1234.56, "$,#.###") 
-1.234,56 €
Print Format$(-1234.56, "($,#.###)")   
(1.234,56 €)

9.2.4 Format syntax for date and time values

yy 	Displays the year with the last two digits. 
yyyyy 	Returns the year with four digits. 
m 	Displays the month. 
mm 	Displays the month with two digits. 
mmm 	Returns the month in abbreviated localized form. 
mmmm 	Displays the month in full localized form. 
d 	Displays the day. 
dd 	Returns the tag with two digits. 
ddd 	Returns the weekday in abbreviated localized form. 
dddd 	Returns the month in full localized form. 
/ 	Outputs the date separator. 
h 	Displays the hours. 
hh 	Displays the hours with two digits. 
n 	Displays the minutes. "and not m, as one would suspect."
nn 	Returns the minutes with two digits. 
s 	Returns the seconds. 
ss 	Returns the seconds with two digits. 
:  	Displays the time separator. 
u 	Returns the milliseconds if they are not zero. As a separator to the seconds, you should be able to insert a dot. 
uuuu 	Outputs the milliseconds with three digits. 
t 	Specifies the time zone (abbreviation).

Attention:
Every character or string in the syntax overview of date and time formats is interpreted in the format string as specified:

Print "Es war "; Format$(Now, "hh:nn Uhr")

It was 09:57 U9r ← Error , because h is a pre-defined sign in the German word 'Uhr'!

Examples:

Print "Heute ist "; Format$(Now(), "dddd"); ", der "; Format$(Now(), "d. mmmm yyyy") 
Print "Es war "; Format$(Now, "hh:nn"); " Uhr!"   
Print "Es war genau "; Format$(Now, "hh:nn:ss.uuu"); " Uhr!"   
Print "Zeit = "; Format(Now(), "hh:nn:ss"); " Uhr!"  ' Current kitchen time ...
Print "UTC  = "; Format(Time(DateAdd(Now(), gb.second, System.TimeZone)), "hh:nn:ss"); " Uhr"  
Print "System.TimeZone = "; System.TimeZone 
Print "System.FirstDayOfWeek = "; System.FirstDayOfWeek
Print "Es war "; Format$(Now, "hh:nn"); " Uhr"; Format$(Now, " (t)")

Today is Wednesday, June 4,2014
It was 09:40 a. m.
It was exactly 09:40:37:37:404 a. m.
Time = 09:40:37 a. m.
UTC = 08:40:37 a. m.
TimeZone = -3600
System.FirstDayOfWeek = 1
It was 09:40 a. m. (CET)</code>


9.2 Benutzer-definierte Formate

Format ( Expression [ , Format ] ) AS String

Die Funktion Format(..) konvertiert einen Ausdruck in einen String. Ein benutzer-definiertes Format können Sie optional mit einem Format-String festlegen, der von der Art des Ausdrucks abhängt. Die Format-Funktion kann Zahlen, Währungen, ein Datum und Zeiten formatieren.

9.2.1 Allgemeine Syntax

Ein benutzer-definiertes Format wird durch eine Folge spezieller Zeichen (Zeichenkette) beschrieben. Zeichen vor und nach dem Format-String werden so ausgegeben, wie sie angegeben sind.

9.2.2 Format-Syntax für einen numerischen Ausdruck

+ 	Gibt das Vorzeichen + der Zahl aus 
- 	Gibt das Vorzeichen - der Zahl aus; aber nur dann, wenn die Zahl negativ ist. 
# 	Gibt eine Ziffer aus, wenn das nötig ist.

Die Zahl wird links mit Leerzeichen aufgefüllt, so dass die Anzahl der ausgegebenen Ziffern vor dem Komma größer oder gleich der Anzahl der # vor dem Komma ist.

Beispiele:

0 	Es wird immer eine Ziffer ausgegeben mit einer vorangestellten Null, wenn das notwendig ist. 
. 	Gibt den Dezimal-Separator aus. 
, 	Gibt den Tausender-Separator aus. 
% 	Multipliziert die Zahl mit 100 und hängt das %-Zeichen an. 
E 	Stellt den Exponential-Teil einer Zahl dar. Das Vorzeichen des Exponenten wird immer ausgegeben. 

Beispiele:

PRINT Format$(Pi, "-#.###") 
3.142 
PRINT Format$(Pi, "+0#.###0") 
+03.1416 
PRINT Format$(Pi / 10, "###.# %") 
31.4 % 
Print Format$(-2.3 ^ 7, "#.####E##") 
-3,405E+2

9.2.3 Format-Syntax für Währungen

Um Währungen zu formatieren, können Sie alle numerischen Format-Zeichen verwenden und zusätzlich die folgenden:

  • $ Gibt das nationale Währungszeichen aus.
  • $$ In diesem Fall wird das internationale Währungszeichen (Kurzform) ausgegeben.
  • ( Symbolisiert einen negativen Währungswert und muss das erste Zeichen im Format-String sein. Sie können eine schließende Klammer ) am Ende des Format-Strings angeben.

Beispiele:

Print Format$(1234.56, "$$#.##") 
1234,56 EUR
Print Format$(-1234.56, "$,#.###") 
-1.234,56 €
Print Format$(-1234.56, "($,#.###)")   
(1.234,56 €)

9.2.4 Format-Syntax für Datums- und Zeitwerte

yy 	Gibt das Jahr mit den letzten zwei Ziffern aus. 
yyyy 	Gibt das Jahr mit vier Ziffern aus. 
m 	Gibt den Monat aus. 
mm 	Gibt den Monat mit zwei Ziffern aus. 
mmm 	Gibt den Monat in abgekürzter lokalisierter Form aus. 
mmmm 	Gibt den Monat in vollständiger lokalisierter Form aus. 
d 	Gibt den Tag aus. 
dd 	Gibt den Tag mit zwei Ziffern aus. 
ddd 	Gibt den Wochentag in abgekürzter lokalisierter Form aus. 
dddd 	Gibt den Monat in vollständiger lokalisierter Form aus. 
/ 	Gibt den Datum-Separator aus. 
h 	Gibt die Stunden aus. 
hh 	Gibt die Stunden mit zwei Ziffern aus. 
n 	Gibt die Minuten aus. ' und nicht m, wie man vermuten würde
nn 	Gibt die Minuten mit zwei Ziffern aus. 
s 	Gibt die Sekunden aus. 
ss 	Gibt die Sekunden mit zwei Ziffern aus. 
: 	Gibt den Zeit-Separator aus. 
u 	Gibt die Millisekunden aus, wenn diese nicht Null sind. Als Trennzeichen zu den Sekunden sollten Sie können Sie einen Punkt einfügen. 
uuu 	Gibt die Millisekunden mit drei Ziffern aus. 
t 	Gibt die Zeitzone (Abkürzung) an.

Achtung: Jedes Zeichen oder jede Zeichenfolge in der Übersicht zur Syntax der Datums- und Zeitformate wird im Format-String so interpretiert, wie es angegeben ist:

Print "Es war "; Format$(Now, "hh:nn Uhr")

Es war 09:57 U9r ← FEHLER

Beispiele:

Print "Heute ist "; Format$(Now(), "dddd"); ", der "; Format$(Now(), "d. mmmm yyyy") 
Print "Es war "; Format$(Now, "hh:nn"); " Uhr!"   
Print "Es war genau "; Format$(Now, "hh:nn:ss.uuu"); " Uhr!"   
Print "Zeit = "; Format(Now(), "hh:nn:ss"); " Uhr!"  ' Aktuelle Küchen-Zeit 
Print "UTC  = "; Format(Time(DateAdd(Now(), gb.second, System.TimeZone)), "hh:nn:ss"); " Uhr"  
Print "System.TimeZone = "; System.TimeZone 
Print "System.FirstDayOfWeek = "; System.FirstDayOfWeek
Print "Es war "; Format$(Now, "hh:nn"); " Uhr"; Format$(Now, " (t)")
Heute ist Mittwoch, der 4. Juni 2014
Es war 09:40 Uhr!
Es war genau 09:40:37.404 Uhr!
Zeit = 09:40:37 Uhr!
UTC  = 08:40:37 Uhr
System.TimeZone = -3600
System.FirstDayOfWeek = 1
Es war 09:40 Uhr (CET)
The website uses a temporary session cookie. This technically necessary cookie is deleted when the browser is closed. You can find information on cookies in our privacy policy.
k9/k9.2/start.txt · Last modified: 02.07.2018 (external edit)

Page Tools