agorum.composite.form.element.date

Dieses Element stellt ein Eingabefeld für Datum / Uhrzeit dar. Wenn ein Benutzer einen ungültigen Wert in das Feld eingibt, wird dieses beim Verlassen wieder auf den zuletzt gültigen Wert zurückgesetzt.

agorum.composite.form.element.date erbt alle Grundeigenschaften von element.

Beispiel einer Oberfläche

---

Skript zur Oberfläche

let aguila = require('common/aguila');

let form = aguila.create({
  width: 500,
  height: 300,
  type: 'agorum.composite.form.basic',

  elements: [
    {
      type: 'agorum.composite.form.element.date',
      name: 'dateField1',
      label: 'Datum 1',
      value: new Date()
    },
    {
      type: 'agorum.composite.form.element.date',
      name: 'dateField2',
      label: 'Datum 2',
      precision: 'minute',
      value: new Date()
    },
    {
      type: 'agorum.composite.form.element.date',
      name: 'dateField3',
      label: 'Datum 3',
      value: new Date(),
      format: 'de|dd. MMMM yyyy',
      readOnly: true
    },     
    {       
      type: 'agorum.composite.form.element.date',
      name: 'dateField4',
      label: 'Datum 4',
      value: new Date(),
      format: 'de|dd. MMMM yyyy HH:mm',
      precision: 'minute',
      readOnly: true
    }
  ]
});

form;

Parameter

---

Alle Parameter in element gelten. Zusätzlich gelten die folgenden Parameter.

value

Übergibt ein Date-Objekt und gibt es gleichzeitig zurück.
 

Beispiel

form.down('dateField1').value = new Date();

precision

Definiert die Art der Eingabe und Anzeige.

• Sie können diesen Parameter nachträglich ändern.
• precision kontrolliert, wie das Datum als Wert zur Verfügung steht.

Mögliche Werte für „precision“

Wert	Beschreibung
day (Default)	Zeigt ein eingegebenes Datum an. Das System stellt die Stunde auf 12 und die Minute, Sekunde und Millisekunde auf 0, da bei der Angabe eines reinen Datums das System davon ausgeht, dass das Datum in jeder Zeitzone gleichermaßen gilt.
hour	Zeigt ein eingegebenes Datum + Stunde an. Das System stellt die Minuten, Sekunden und Millisekunden automatisch auf 0.
minute	Zeigt ein eingegebenes Datum + Stunde + Minute an.
second	Zeigt ein eingegebenes Datum + Stunde + Minute + Sekunde an.
millisecond	Zeigt ein eingegebenes Datum + Stunde + Minute + Sekunde + Millisekunde an.

 

Beispiel

form.down('dateField1').precision = 'minute';

format

Übergibt für die Anzeige ein eigen definiertes Format.

• Sie können diesen Parameter nachträglich ändern.
• Die Anzeige orientiert sich automatisch am Parameter precision und an der Sprache des Benutzers, wenn Sie kein Format definieren.
• Im Standard verwendet das System für die Formatierung die Sprache des Benutzers.
• Sie können die Sprache überschreiben, indem Sie die Sprache vor das Format stellen und mit | trennen:

de|dd. MMMM yyyy

Beispiel

form.down('dateField1').format = 'dd.MM.yyyy';

Weitere Formate

• dd.MM.yyyy (01.01.2019)
• de|dd. MMMM yyyy (01. Januar 2019) – de steht für deutsche Ausgabe.
• dd.MM.yyyy HH:mm:ss (01.01.2019 12:50:00)

Informationen zu dieser Formatierung siehe https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html

Events

---

Alle Events in element gelten.

precisionChanged

Löst aus, wenn sich der Parameter precision ändert.

Als Parameter übergibt das System die neue precision.

formatChanged

Löst aus, wenn sich der Parameter format ändert. 

Als Parameter übergibt das System das neue format.