Textplatzhalter für Datums- und Zeitangaben

Verwendung von Datums- & Zeitangaben mit Berechnungen in Vorlagen

Mit diesen Platzhaltern kann Bezug auf das aktuelle Datum genommen werden. Die Funktionen und Möglichkeiten zur Berechnung von Datumswerten wurden bereits im Kapitel über die Dokumentvorlagen ausführlich beschrieben.

Bitte beachten: Wird mittels Dialog ein Stichtag zur Verwendung in der Vorlage entgegen genommen, verändert sich die Datumsgrundlage der Platzhalter aus DATUM und ZEIT wie auch des DATUMSBEREICH. Ein Beispiel für eine solche Verwendung ist der „Bericht an die Betreuungsbehörde“. Statt des aktuellen Datums ist dann für die nachfolgenden Platzhalter das gesetzte Datum als Grundlage.

Da man häufig Datums- und Zeitangaben in verschiedensten Ausprägungen besonders in Textvorlagen benötigt, verfügen einige der Platzhalter über umfangreiche Formatierungsmöglichkeiten.

Formatangaben #datum(format)# und #datum_heute(format)#

Der Parameter „format“ muss als numerischer Wert im Bereich 1 bis 7 angegeben werden und beeinflusst dadurch die Darstellung des Datums.

  • 1: Ausgabe des Datums im Format TT.MM.JJJJ (Beispiel „17.09.2011“)
  • 2: Ausgabe des Datums im Format TT. Monat JJJJ (Beispiel „17. September 2011“)
  • 3: Ausgabe des Datums im Format T.M.JJ (Beispiel „17.9.11“)
  • 4: Ausgabe des Wochentags als Abkürzung (Beispiel „MO“)
  • 5: Ausgabe des Wochentags (Beispiel „Montag“)
  • 6: Ausgabe des Monats als Abkürzung (Beispiel „SEP“)
  • 7: Ausgabe des Monats (Beispiel „September“)
Berechnungen im Platzhalter #datum(…)#

Um besonders bei Vorlagen für die Angaben von Fristen oder Zeiträumen flexibel zu sein, erlaubt Ihnen der Platzhalter #datum(tag.monat.jahr,format)# umfangreiche Berechnungen. So sind Angaben von exakten Datumsangaben für „in vier Wochen“ z.B. für Fristangaben kein Problem.

Es ist zu beachten, dass die drei Elemente dieses Parameters mit einem Punkt voneinander getrennt werden. Der erste Teil „tag“ entspricht der Tageszahl des aktuellen Datums, der zweite Teil „monat“ der Monatszahl und der dritte teil „jahr“ der Jahreszahl.

Zu jedem Teil des Parameters kann eine beliebige Anzahl von Tagen, Monaten oder Jahren addiert oder subtrahiert werden, indem an das Teilelement „+“ bzw. „-“ gefolgt von der Anzahl der Tage angehängt wird.

  • #datum(tag+1.monat.jahr,format)# morgen
  • #datum(tag+28.monat.jahr,format)# in 4 Wochen
  • #datum(tag.monat+24.jahr,format)# in 24 Monaten
  • #datum(tag.monat+1.jahr-1,format)# vor 11 Monaten

Als Zweiter Parameter muss wie vorher beschrieben zusätzlich die Formatangabe folgen. Der Format-Parameter muss mit einem Komma vom ersten Parameter getrennt werden.

Platzhalter Datum & Zeit

PlatzhalterRückgabewert
#datum#Tagesdatum
#datum(format)#Tagesdatum mit Formatangabe
#datum(tag.monat.jahr,format)#Tagesdatum mit Möglichkeit zusätzlicher Berechnungen
#datum+7#Datum+7 Tage ("nächste Woche")
#datum+14#Datum + 14 Tage ("in zwei Wochen)
#datum+21#Datum + 21 Tage ("in drei Wochen")
#tag#Tageszahl des Datums
#monat#Monatszahl des Datums
#jahr#Jahreszahl des Datums
#uhrzeit#Aktuelle Uhrzeit im Format HH:MM
#uhrzeitlang#Aktuelle Uhrzeit im Format HH:MM:SS
#datum_heute#Aktuelles Datum (unabhängig von geändertem Stichtag)
#datum_heute(format)#Aktuelles Datum mit Formatangabe (unabhängig von geändertem Stichtag)

Datumsbereich

Mit den folgenden Platzhaltern kann ein Zeitbereich definiert werden, der Einfluss auf die Ausgabe anderer Platzhalter haben kann. Die Platzhalter können mehrfach in einer Dokumentvorlage verwendet werden und setzen ab der aktuellen Verwendung für alle folgenden Platzhalter, die den Datumsbereich auswerten das Startdatum und Enddatum.

Ein Beispiel für Platzhalter, die den Datumsbereich auswerten, ist die Tabelle mit den Konten der Klienten. Basierend auf dem angegebenen Datumsbereich werden dort Anfangssaldo, Einnahmen, Ausgaben und Endsaldo berechnet.

PlatzhalterRückgabewert
#datumsbereich(tag.monat.jahr,tag.monat.jahr,format)#Über zwei Parameter können zwei Daten zur Anzeige eines Datumsbereiches angegeben werden. Als Formatangabe im dritten Parameter werden die Werte 1 bis 3 akzeptiert.
#setbereich(tag.monat.jahr,tag.monat.jahr)#Wie #datumsbereich(...)# jedoch ohne Ausgabe im Text
#setstart(tag.monat.jahr)#Setzt nur den Beginn eines Datumsbereiches (ohne Textausgabe)
#setende(tag.monat.jahr)#Setzt nur das Ende eines Datumsbereiches (ohne Textausgabe)
#startdatum#Ausgabe des aktuell gesetzten Startdatum
#endedatum#Ausgabe des aktuell gesetzten Enddatum

veröffentlicht am 24.März 2015