Name
OPEN

Syntax
kanal = OPEN ("DateTime", "", format)

Aufklappen Wertebereiche
kanal ≥ 0, Typ integer
format, Typ string, spezifisch (s.u.)

Aufklappen Erläuterung
Mit diesem Befehl wird ein Kanal geöffnet, um die Datums- und Uhrzeitangaben der Systemzeit des Rechners auszulesen. Die geöffnete Kanalnummer wird kanal zugewiesen.
Mit format wird dem Addon übergeben, welches Rückgabeformat von Datum und Zeit erwartet wird. Folgende Bestandteile des strings, die durch Leerzeichen voneinander zu trennen sind, sind möglich:

%x Datum im Format der Systemeinstellungen (in DE: 20.01.2006)
%X Zeit im Format der Systemeinstellungen (in DE: 14:30:09)
%c Datum und Zeit im Format der Systemeinstellungen (in DE: 20.01.2006 14:24:01)
%A Wochentag-Name
%a abgekürzter Wochentag-Name
%d Tag des Monats als eine Dezimalzahl (01-31)
%m Monat, als Dezimalzahl (01-12)
%B Monatsname
%b abgekürzter Monatsname
%Y Jahr mit Jahrhundert, als eine Dezimalzahl in der Form 2006
%y Jahr ohne Jahrhundert, als eine Dezimalzahl in der Form 06
%H Stunde (24-Stunden Uhr), als Dezimalzahl (00-23)
%I Stunde (12-Stunden Uhr), als Dezimalzahl (01-12)
%M Minute, als Dezimalzahl (00-59)
%P AM/PM Bezeichnung für eine 12-Stunden Uhr, wenn nach Systemeinstellung nicht üblich: leer
%S Sekunde, als Dezimalzahl (00-61)
%j Tag des Jahres, als Dezimalzahl (001-366)
%U Wochennummer des Jahres (wenn Sonntag der erster Tag der Woche ist),als Dezimalzahl (00-53)
%W Wochennummer des Jahres (wenn Montag der erster Tag der Woche ist), als Dezimalzahl (00-53)
%w Wochentag, als Dezimalzahl (0=Sonntag, 6=Samstag)
%Z gibt die Zeitzone aus in der Form "Westeuropäische Normalzeit"
%z gibt die Zeitzone aus in der Form "Westeuropäische Normalzeit"
%% gibt das Zeichen % aus

Weitere Zeichen sind zulässig, aber ohne AddOn-steuernde Funktion.

Aufklappen Beispiel
kanal = OPEN ("DateTime", "", "%Y-%m-%d")
sts = INPUT (kanal, "", "", datum)
CLOSE 1
PRINT datum
! Zeigt: 2021-04-18

Öffnet das AddOn auf kanal, liest das Datum/ die Zeit und schließt den Kanal. Ausgabe des strings.

Aufklappen ArchiCAD
ab 5.0