.. highlightlang:: us

.. index:: DT_Format

.. _dt_format:

DT_Format
=========

.. us.tag  DT_Format GERMAN DT_FUNC

:ref:`DT_Format` konvertiert eine Gleitkommazahl, die ein Datum enthält, in eine
Zeichenkette.

.. function::  smRet = DT_Format(rmDate)
               smRet = DT_Format(rmDate, ssFormat)

.. us.return

**Returnwert**

*smRet* ist eine Matrix von Zeichenketten.

.. us.params

**Parameter**

.. uparam:: rmDate

   *rmDate* ist eine reelle Matrix.

.. uparam:: ssFormat

   *ssFormat* ist ein skalarer String mit eingebetteten Formatierungzeichen. Wird
   der Parameter *ssFormat* weggelassen, wird die Formatzeichenkette ``"%c"`` 
   verwendet. Formatierungszeichen für *ssFormat*:

   .. list-table::
      :header-rows: 1

      * - Wert
        - Bedeutung
      * - %a
        - Abgekürzter Wochentagsname
      * - %A
        - Wochentagsname
      * - %B
        - Monatsname
      * - %c
        - Datum und Zeit passend für aktuelle Ländereinstellungen
      * - %d
        - Tag des Monats als Dezimalzahl (01 - 31)
      * - %H
        - Stunde im 24-Stundenformat (00 - 23)
      * - %I
        - Stunde im 12-Stundenformat (01 - 12)
      * - %j
        - Tag des Jahres als Dezimalzahl (001 - 366)
      * - %t
        - als Dezimalzahl (01 - 12)
      * - %m
        - Monat als Dezimalzahl (1 - 12)
      * - %M
        - Minute als Dezimalzahl (00 - 59)
      * - %p
        - Aktueller Länder-A.M./P.M.-Indikator für 12-Stunden Uhr
      * - %S
        - Sekunde als Dezimalzahl (00 - 59)
      * - %U
        - Woche des Jahres, Sonntag erster Tag (00 - 51)
      * - %w
        - Wochentag als Dezimalzahl (0 - 6; Sonntag ist 0)
      * - %W
        - Woche des Jahres, Montag erster Tag (00 - 51)
      * - %x
        - Datum für aktuelle Ländereinstellungen
      * - %X
        - Zeit für aktuelle Ländereinstellungen
      * - %y
        - Jahr ohne Jahrhundert als Dezimalzahl (00 - 99)
      * - %Y
        - Jahr mit Jahrhundert als Dezimalzahl
      * - %z, %Z
        - Zeitzonenname oder Abkürzung
      * - %%
        - Prozentzeichen
      * - ##
        - Entferne führende Nullen (falls vorhanden) Beispiel: %#m

.. us.comment

**Kommentar**

Der Parameter *ssFormat* besteht aus einem oder mehreren Formatierungszeichen.
Wie bei der *printf* Funktion beginnt ein Formatierungszeichen mit einem
Prozentzeichen (%). Buchstaben, die nicht mit einem Prozentzeichen beginnen
werden ohne Änderung in die Rückgabezeichenkette kopiert. Die Ausgabe der
Funktion ist von der Ländereinstellung abhängig.

Um beim ``"%c"``-Format eine vierstellige Jahresangabe bei zu erhalten, muss in
der Ländereinstellung von Windows für die kurze Datumsangabe die Zeichenkette
``TT.MM.JJJJ`` eingegeben werden.

Wie bei der *printf* Funktion hat das # Zeichen ein
besondere Bedeutung:

%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%: # flag wird ignoriert

%#c: Langes Datum/Zeitformat für die eingestellte Ländereinstellung.

Beispiel: ``"Tuesday, March 14, 1995, 12:41:29"``

%#x:Langes Datum für die eingestellte Ländereinstellung.

Beispiel: ``"Tuesday, March 14, 1995"``

%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y: Führende Nullen
werden entfernt (falls vorhanden).

.. us.example

**Beispiel**

::

   * d = DT_GetCurrentTime()
   * d
   35992.3731
   * DT_Format(d, "%c")
   16.07.98 08:57:14
   * DT_Format(d, "%#c")
   Donnerstag, 16. Juli 1998 08:57:14
   * DT_Format(d, "%x")
   16.07.98
   * DT_Format(d, "%X")
   08:57:14

.. seealso::
   :ref:`uberblick-datum-und-zeit`,
   :ref:`DT_SetLocale`,
   :ref:`DT_ParseDateTime`,
   :ref:`DT_GetCurrentTime`

:sub:`id-1118602`