Date (SPT-Tag): Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
(10 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
==Name== | ==Name== | ||
− | <spt:date> - | + | <spt:date> - Datums- und Uhrzeiteingabe mit Prüfung auf Gültigkeit |
==Syntax== | ==Syntax== | ||
Zeile 8: | Zeile 8: | ||
==Beschreibung== | ==Beschreibung== | ||
− | Mit dem <code>sp:date</code>-Tag können Datumseingaben im Template auf ihre Gültigkeit überprüft werden. Gültige Datumseingaben haben das Format <code>tt.mm.jjjj</code>, wobei führende Nullen im Tages- oder Monatswert weggelassen werden können. | + | Mit dem <code>sp:date</code>-Tag können Datumseingaben im Template auf ihre Gültigkeit überprüft werden. Gültige Datumseingaben haben das Format <code>tt.mm.jjjj</code>, wobei führende Nullen im Tages- oder Monatswert weggelassen werden können. Mit der Option type="datetime" erstelle Datumsfelder können ein minutengenaues Datum erfassen, indem die Uhrzeit in einem separaten Feld im Format <code>hh:mm</code> eingegeben werden kann. Auch hier dürfen führende Nullen im Stunden- oder Minutenwert weggelassen werden. |
==Attribute== | ==Attribute== | ||
− | {| class="prettytable" | + | {| class="prettytable sortable" |
|- class="hintergrundfarbe1" | |- class="hintergrundfarbe1" | ||
! Name || Type || Required || Default || ab IES Version | ! Name || Type || Required || Default || ab IES Version | ||
|- | |- | ||
− | | | + | {{sp_input_attributes|attribute=name|mode=row}} |
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| <code>value</code> | | <code>value</code> | ||
| [[String]] | | [[String]] | ||
| Nein | | Nein | ||
− | | [[System|system.now]] | + | | ${[[System|system.now]]} |
| 1 | | 1 | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | <code> | + | | <code>placeholder</code> |
− | | [[ | + | | [[Date]] |
| Nein | | Nein | ||
− | | | + | | |
− | + | | 3.12 | |
|- | |- | ||
{{sp_input_attributes|attribute=fixvalue|mode=row}} | {{sp_input_attributes|attribute=fixvalue|mode=row}} | ||
Zeile 59: | Zeile 42: | ||
| 20 | | 20 | ||
| 1 | | 1 | ||
+ | |- | ||
+ | | <code>type</code> | ||
+ | | [[String]] | ||
+ | | Nein | ||
+ | | date | ||
+ | | 2.1.0.44 | ||
+ | |- | ||
+ | | <code>nowButton</code> | ||
+ | | [[Boolean]] | ||
+ | | Nein | ||
+ | | true | ||
+ | | 3.1 | ||
|- | |- | ||
{{sp_input_attributes|attribute=dynamics|mode=row}} | {{sp_input_attributes|attribute=dynamics|mode=row}} | ||
|} | |} | ||
{{sp_input_attributes|attribute=name|mode=desc}} | {{sp_input_attributes|attribute=name|mode=desc}} | ||
+ | ;<code>placeholder</code> | ||
+ | :Muss ein Datum sind und wird als Placeholder eingesetzt | ||
;<code>value</code> | ;<code>value</code> | ||
:Vorgabetext für das erzeugte Eingabefeld. Ohne bzw. mit einem leeren <code>value</code>-Attribut wird in der Eingabe das aktuelle Datum angezeigt. Soll das Eingabefeld leer bleiben, muss als <code>value</code> ein Leerzeichen (" ") angegeben werden. | :Vorgabetext für das erzeugte Eingabefeld. Ohne bzw. mit einem leeren <code>value</code>-Attribut wird in der Eingabe das aktuelle Datum angezeigt. Soll das Eingabefeld leer bleiben, muss als <code>value</code> ein Leerzeichen (" ") angegeben werden. | ||
Zeile 68: | Zeile 65: | ||
{{sp_input_attributes|attribute=locale|mode=desc}} | {{sp_input_attributes|attribute=locale|mode=desc}} | ||
{{sp_input_attributes|attribute=type|mode=desc}} | {{sp_input_attributes|attribute=type|mode=desc}} | ||
+ | :date = Einfaches Eingabefeld im Format <code>TT.MM.JJJJ</code> | ||
+ | :datetime = Zweifaches Eingabefeld für separate Eingabe von Datum und Uhrzeit im Format <code>TT.MM.JJJJ</code> und <code>HH:MM</code> | ||
{{sp_input_attributes|attribute=disabled|mode=desc}} | {{sp_input_attributes|attribute=disabled|mode=desc}} | ||
{{sp_input_attributes|attribute=readonly|mode=desc}} | {{sp_input_attributes|attribute=readonly|mode=desc}} | ||
;<code>size</code> | ;<code>size</code> | ||
:'size'-Wert des generierten input-Tags. | :'size'-Wert des generierten input-Tags. | ||
+ | ;<code>nowButton</code> | ||
+ | :Zeigt bei true eine Schaltfläche zum setzen des aktuellen Zeitpunkts an | ||
{{sp_input_attributes|attribute=dynamics|mode=desc}} | {{sp_input_attributes|attribute=dynamics|mode=desc}} | ||
Aktuelle Version vom 1. Juni 2023, 11:33 Uhr
Name
<spt:date> - Datums- und Uhrzeiteingabe mit Prüfung auf Gültigkeit
Syntax
<spt:date name="variable"/>
Beschreibung
Mit dem sp:date
-Tag können Datumseingaben im Template auf ihre Gültigkeit überprüft werden. Gültige Datumseingaben haben das Format tt.mm.jjjj
, wobei führende Nullen im Tages- oder Monatswert weggelassen werden können. Mit der Option type="datetime" erstelle Datumsfelder können ein minutengenaues Datum erfassen, indem die Uhrzeit in einem separaten Feld im Format hh:mm
eingegeben werden kann. Auch hier dürfen führende Nullen im Stunden- oder Minutenwert weggelassen werden.
Attribute
Name | Type | Required | Default | ab IES Version |
---|---|---|---|---|
name
|
Variable | Ja | None | 1 |
value
|
String | Nein | ${system.now} | 1 |
placeholder
|
Date | Nein | 3.12 | |
fixvalue
|
Text | Nein | None | 1 |
locale
|
Locale | Nein | None | 1 |
disabled
|
Condition | Nein | None | 1 |
readonly
|
Condition | Nein | None | 1 |
size
|
Number | Nein | 20 | 1 |
type
|
String | Nein | date | 2.1.0.44 |
nowButton
|
Boolean | Nein | true | 3.1 |
Dynamische Attribute | Text | Nein | None | 1 |
name
- Bestimmt den Namen des Feldes.
placeholder
- Muss ein Datum sind und wird als Placeholder eingesetzt
value
- Vorgabetext für das erzeugte Eingabefeld. Ohne bzw. mit einem leeren
value
-Attribut wird in der Eingabe das aktuelle Datum angezeigt. Soll das Eingabefeld leer bleiben, muss alsvalue
ein Leerzeichen (" ") angegeben werden.
fixvalue
- Überschreibt jeden vorhandenen Inhalt der mit
name
bestimmten Variablen mit dem durchfixvalue
angegebenen Wert.
locale
- Dieses Attribut bestimmt die Mehrsprachigkeit der Variablen.
type
- Der Typ des Eingabefeldes.
- date = Einfaches Eingabefeld im Format
TT.MM.JJJJ
- datetime = Zweifaches Eingabefeld für separate Eingabe von Datum und Uhrzeit im Format
TT.MM.JJJJ
undHH:MM
disabled
- HTML-Attribut (true, false).
readonly
- HTML-Attribut (true, false).
size
- 'size'-Wert des generierten input-Tags.
nowButton
- Zeigt bei true eine Schaltfläche zum setzen des aktuellen Zeitpunkts an
- Dynamische Attribute
- Dynamische Attribute sind beliebige HTML-Attribute, die evaluiert und bis zum HTML-Tag durchgereicht werden.
Beispiele
Datum ausgeben
Template Quelltext
<sp:io type="in">
Datum (TT.MM.JJJJ) <spt:date name="date_test" value=" "/>
</sp:io>
<sp:io type="out">
<sp:print name="date_test" dateformat="dd.MM.yyyy"/>
</sp:io>