Quiq::Epoch - Ein Zeitpunkt
Quiq::Object
Anzahl der Sekunden seit 1.1.1970, 0 Uhr UTC in hoher Auflösung, also mit Nachkommastellen.
Zeitangabe in der Darstellung YYYY-MM-DD HH:MI:SS.X.
YYYY-MM-DD HH:MI:SS.X
Ein Objekt der Klasse repräsentiert einen Zeitpunkt. Die Klasse implementiert Operationen auf einem solchen Zeitpunkt. Der Zeitpunkt ist hochauflösend, umfasst also auch Sekundenbruchteile.
$t = $class->new; $t = $class->new($epoch); $t = $class->new($iso);
Instantiiere ein Zeitpunkt-Objekt für Epoch-Wert $epoch bzw. ISO-Zeitangabe $iso, letztere interpretiert in der lokalen Zeitzone, und liefere dieses Objekt zurück. Ist kein Argument angegeben, wird der aktuelle Zeitpunkt genommen.
$i = $t->dayOfWeek;
Integer
Liefere Wochentagsnummer im Bereich 0-6, 0 = Sonntag.
$abbr = $ti->dayAbbr;
String
Liefere abgekürzten Wochentagsnamen (So, Mo, Di, Mi, Do, Fr, Sa).
$name = $ti->dayName;
Liefere Wochentagsname (Sonntag, Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag).
$year = $t->year;
Liefere (vierstellige) Jahreszahl.
$t = $t->minus($duration);
Dauer, um die der Zeitpunkt in die Vergangenheit verschoben wird. Die Dauer wird wie beim Konstruktor von Quiq::Duration angegeben.
Geändertes Epoch-Objekt (für Method-Chaining)
Verschiebe den Zeitpunkt um Dauer $duration in die Vergangenheit.
$t = $t->plus($duration);
Dauer, um die der Zeitpunkt in die Zukunft verschoben wird. Die Dauer wird wie beim Konstruktor von Quiq::Duration angegeben.
Verschiebe den Zeitpunkt um Dauer $duration in die Zukunft.
$s = $this->tzOffset;
Anzahl Sekunden (Integer)
Ermittele den aktuellen Offset der lokalen Zeitzone gegenüber UTC in Sekunden und liefere diesen zurück.
Quiq::Epoch->tzOffset; # MEST ==> 7200
(in Zeitzone MESZ)
$epoch = $t->epoch;
Liefere den Epoch-Wert des Zeitpunkts.
Quiq::Epoch->new->epoch; ==> 1464342621.73231
($s,$mi,$h,$d,$m,$y) = $t->localtime;
Liefere die Zeitkomponenten Sekunden, Minuten, Stunden, Tag, Monat, Jahr in lokaler Zeit. Im Unterschied zu localtime() aus dem Perl Core sind Monat ($m) und Jahr (y) "richtig" wiedergegeben. d.h die Komponente $m muss nicht um 1 erhöht und die Komponente $y muss nicht um 1900 erhöht werden.
Quiq::Epoch->new(1559466751)->localtime; ==> (31,12,11,2,6,2019) # 2019-06-02 11:12:31
$str = $t->as($fmt);
Formatangabe. Folgende Formate sind definiert:
Datum in ISO-Darstellung.
Zeit in ISO-Darstellung.
Zeit in ISO-Darstellung mit Nachkommastellen. Die Anzahl der X gibt die Anzahl der Nachkommastellen an (in obiger Angabe drei).
Zeit-Darstellung (String)
Liefere eine externe Darstellung des Zeitpunkts gemäß Formatangabe $fmt. Der Zeitpunkt wird in der lokalen Zeitzone interpretiert.
Quiq::Epoch->new->as('YYYY-MM-DD HH:MI:SS'); => 2016-05-27 11:50:21
$str = $t->asIso; $str = $t->asIso($x);
Anzahl der Nachkommastellen.
1.188
Frank Seitz, http://fseitz.de/
Copyright (C) 2020 Frank Seitz
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Quiq, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Quiq
CPAN shell
perl -MCPAN -e shell install Quiq
For more information on module installation, please visit the detailed CPAN module installation guide.