Modul ConvertTimeZone (CTZ) - Versionsgeschichte

DS Starter am 10. September 2022 um 07:23 Uhr

2022-09-10T07:23:39Z

← Nächstältere Version		Version vom 10. September 2022, 09:23 Uhr
Zeile 203:		Zeile 203:
	my $params = {		my $params = {
	name => $name,		name => $name,
	pattern => "%Y-%m-%dT%H%M%S",		pattern => '%Y-%m-%dT%H%M%S',
	dtstring => '2022-09-09T173000.0000000Z',		dtstring => '2022-09-09T173000.0000000Z',
	tzcurrent => 'UTC',		tzcurrent => 'UTC',

DS Starter am 10. September 2022 um 07:22 Uhr

2022-09-10T07:22:11Z

← Nächstältere Version		Version vom 10. September 2022, 09:22 Uhr
Zeile 36:		Zeile 36:

	<pre>		<pre>
	use FHEM::Utility::CTZ qw(convertTimeZone getTZNames);		use FHEM::Utility::CTZ qw(convertTimeZone getTZNames reqModFail);
	</pre>		</pre>

	Das Modul stellt nachfolgend beschriebene Funktionen bereit.		Das Modul stellt nachfolgend beschriebene Funktionen bereit.

			=reqModFail=

			Die Funktion prüft, ob die vorausgesetzten Perl Module installiert sind und gibt im Fehlerfall das/die fehlenden Perl Module zurück.
			Sind alle benötigten Perl Module installiert wird <code>undef</code> zurück gegeben.

			Aufruf:

			:<syntaxhighlight lang="perl">
			my $rmf = reqModFail();

			if ($rmf) {
			# Fehlerbehandlung
			}
			</syntaxhighlight>

	= getTZNames =		= getTZNames =

DS Starter am 10. September 2022 um 07:10 Uhr

2022-09-10T07:10:24Z

← Nächstältere Version		Version vom 10. September 2022, 09:10 Uhr
Zeile 115:		Zeile 115:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! Parameter !! Optional !! Beispiel !! Beschreibung		!Parameter!!Optional!!Beispiel!!Beschreibung
	\|-		\|-
	\| '''<code>name</code>''' \|\| nein \|\| "LogDB" \|\| Der Name des aufrufenden Device.		\|'''<code>name</code>'''\|\|nein\|\|'LogDB'\|\|Der Name des aufrufenden Device.
	\|-		\|-
	\| '''<code>dtstring</code>''' \|\| nein \|\| '2022-03-09 22:17:45' \|\| Der Original-Zeitstring der umgewandelt werden soll. Der Zeitstring kann auch Millisekunden enthalten. Die Form ist diesem Fall YYYY-MM-DD hh:mm:ss.xxx		\|'''<code>dtstring</code>'''\|\|nein\|\|'2022-03-09 22:17:45'\|\|Der Original-Zeitstring der umgewandelt werden soll. Der Zeitstring kann auch Millisekunden enthalten. Die Form ist diesem Fall YYYY-MM-DD hh:mm:ss.xxx
	\|-		\|-
	\| '''<code>~~tzcurrent~~</code>''' \|\| ja \|\| '~~Europe/Berlin~~' \|\| ~~Die Zeitzone des Original-Zeitstrings (~~dtstring). ~~Es kann~~ '~~local~~' ~~angegeben werden~~. ~~In diesem Fall wird die Zeitzone des Systems versucht automatisch zu ermitteln~~. ~~Das gilt ebenso wenn tzcurrent nicht~~ angegeben ~~ist~~.		\|'''<code>pattern</code>'''\|\|ja\|\|'%Y-%m-%dT%H%M%S'\|\|Das Pattern Format von 'dtstring'. Standard ist '%Y-%m-%d %H:%M:%S'. Weitere mögliche Pattern Muster sind unter [https://metacpan.org/pod/DateTime::Format::Strptime#STRPTIME-PATTERN-TOKENS DateTime::Format::Strptime] angegeben.
	\|-		\|-
	\| '''<code>~~tzconv~~</code>''' \|\| ja \|\| '~~Asia~~/~~Singapore~~' \|\| Die Zeitzone ~~in welche der übergebene Zeitstring konvertiert~~ werden ~~soll~~. ~~Ist tzconv~~ nicht angegeben~~, wird 'UTC' verwendet~~.		\|'''<code>tzcurrent</code>'''\|\|ja\|\|'Europe/Berlin'\|\|Die Zeitzone des Original-Zeitstrings (dtstring). Es kann 'local' angegeben werden. In diesem Fall wird die Zeitzone des Systems versucht automatisch zu ermitteln. Das gilt ebenso wenn tzcurrent nicht angegeben ist.
	\|-		\|-
	\| '''<code>writelog</code>''' \|\| ja \|\| 1 \|\| 1 - der originale und der konvertierte Zeitstring werden mit der (ermittelten) Zeitzone (Abkürzung) im Log ausgegeben<br> 0 - es erfolgt keine Ausgabe im Log		\|'''<code>tzconv</code>'''\|\| ja\|\|'Asia/Singapore'\|\|Die Zeitzone in welche der übergebene Zeitstring konvertiert werden soll. Ist tzconv nicht angegeben, wird 'UTC' verwendet.
			\|-
			\|'''<code>writelog</code>'''\|\|ja\|\|1\|\|1 - der originale und der konvertierte Zeitstring werden mit der (ermittelten) Zeitzone (Abkürzung) im Log ausgegeben<br> 0 - es erfolgt keine Ausgabe im Log
	\|}		\|}

Zeile 173:		Zeile 175:
	tzcurrent => 'UTC',		tzcurrent => 'UTC',
	tzconv => 'Europe/Berlin', # oder 'local'		tzconv => 'Europe/Berlin', # oder 'local'
			writelog => 0
			};

			my ($err, $dtconv) = convertTimeZone ($params);
			</syntaxhighlight>

			Ein weiteres Beispiel zur Umwandlung des erweiterten UTC Formats in die lokale Zeit:

			:<syntaxhighlight lang="perl">
			my $name = "xxx";
			...
			my $params = {
			name => $name,
			pattern => "%Y-%m-%dT%H%M%S",
			dtstring => '2022-09-09T173000.0000000Z',
			tzcurrent => 'UTC',
			tzconv => 'local',
	writelog => 0		writelog => 0
	};		};

DS Starter am 12. März 2022 um 22:32 Uhr

2022-03-12T22:32:23Z

← Nächstältere Version		Version vom 13. März 2022, 00:32 Uhr
Zeile 23:		Zeile 23:

	<pre>		<pre>
	sudo apt install libdatetime-perl		sudo apt-get install libdatetime-perl
	sudo apt-get install libdatetime-format-strptime-perl		sudo apt-get install libdatetime-format-strptime-perl
	</pre>		</pre>

DS Starter am 12. März 2022 um 22:15 Uhr

2022-03-12T22:15:24Z

← Nächstältere Version		Version vom 13. März 2022, 00:15 Uhr
Zeile 20:		Zeile 20:

	installiert sein.		installiert sein.
			Sind diese Module nicht vorhanden, können sie leicht mit dem FHEM Installer bzw. mit folgenden Befehlen installiert werden:

			<pre>
			sudo apt install libdatetime-perl
			sudo apt-get install libdatetime-format-strptime-perl
			</pre>

	Das Modul muß vor der Verwendung eingebunden werden mit		Das Modul muß vor der Verwendung eingebunden werden mit

DS Starter am 12. März 2022 um 19:55 Uhr

2022-03-12T19:55:52Z

← Nächstältere Version		Version vom 12. März 2022, 21:55 Uhr
Zeile 11:		Zeile 11:
	So können zum Beispiel lokale Zeitangaben in UTC bzw. von UTC in lokale Zeit konvertiert werden.		So können zum Beispiel lokale Zeitangaben in UTC bzw. von UTC in lokale Zeit konvertiert werden.
	Das Modul ist sowohl zur Verwendung in FHEM-Modulen als auch in eigenen Routinen ([[99 myUtils anlegen\|99_myUtils]]) geeignet.		Das Modul ist sowohl zur Verwendung in FHEM-Modulen als auch in eigenen Routinen ([[99 myUtils anlegen\|99_myUtils]]) geeignet.

			Auf dem System müssen die Perl-Module

			<pre>
			DateTime
			DateTime::Format::Strptime
			</pre>

			installiert sein.

	Das Modul muß vor der Verwendung eingebunden werden mit		Das Modul muß vor der Verwendung eingebunden werden mit

Ph1959de: Infobox eingefügt; Tags (deprecated) durch ersetzt

2022-03-12T18:09:01Z

Infobox eingefügt; <source> Tags (deprecated) durch <syntaxhighlight> ersetzt

← Nächstältere Version		Version vom 12. März 2022, 20:09 Uhr
Zeile 1:		Zeile 1:
			{{Infobox Modul
			\|ModPurpose=Zeitzonenumrechnung
			\|ModType=x
			\|ModCmdRef=CTZ
			\|ModFTopic=115379
			\|ModForumArea=Sonstiges
			\|ModTechName=CTZ.pm
			\|ModOwner=DS_Starter ({{Link2FU\|16933\|Forum}}/[[Benutzer Diskussion:DS_Starter\|Wiki]])
			}}
	Das Modul CTZ.pm konvertiert Zeitstrings von einer Zeitzone in eine andere Zeitzone.		Das Modul CTZ.pm konvertiert Zeitstrings von einer Zeitzone in eine andere Zeitzone.
	So können zum Beispiel lokale Zeitangaben in UTC bzw. von UTC in lokale Zeit konvertiert werden.		So können zum Beispiel lokale Zeitangaben in UTC bzw. von UTC in lokale Zeit konvertiert werden.
	Das Modul ist sowohl zur Verwendung in FHEM-Modulen als auch in eigenen Routinen (99_myUtils) geeignet.		Das Modul ist sowohl zur Verwendung in FHEM-Modulen als auch in eigenen Routinen ([[99 myUtils anlegen\|99_myUtils]]) geeignet.

	Das Modul muß vor der Verwendung eingebunden werden mit		Das Modul muß vor der Verwendung eingebunden werden mit
Zeile 21:		Zeile 30:
	Die Funktion '''getTZNames''' liefert eine Array Referenz zu einer Liste aller Zeitzonen, die mit diesem Modul verwendet werden können.		Die Funktion '''getTZNames''' liefert eine Array Referenz zu einer Liste aller Zeitzonen, die mit diesem Modul verwendet werden können.

	:<~~source~~ lang="perl">		:<syntaxhighlight lang="perl">
	my $list = getTZNames ();		my $list = getTZNames ();
	</~~source~~>		</syntaxhighlight>

	Mit einem get-Befehl kann zum Beipiel die komplette Liste abgerufen werden:		Mit einem get-Befehl kann zum Beipiel die komplette Liste abgerufen werden:

	:<~~source~~ lang="perl">		:<syntaxhighlight lang="perl">
	sub XXX_Get {		sub XXX_Get {
	my ($hash, @a) = @_;		my ($hash, @a) = @_;
Zeile 47:		Zeile 56:
	return;		return;
	}		}
	</~~source~~>		</syntaxhighlight>

	Es erscheint die Liste der verwendbaren Zeitzonen:		Es erscheint die Liste der verwendbaren Zeitzonen:
Zeile 82:		Zeile 91:
	Aufruf:		Aufruf:

	:<~~source~~ lang="perl">		:<syntaxhighlight lang="perl">
	my ($err, $dtconv) = convertTimeZone ($params);		my ($err, $dtconv) = convertTimeZone ($params);
	</~~source~~>		</syntaxhighlight>

	Der Parameter $params ist eine Referenz auf eine Hash-Struktur, welche die einzelnen Parameter enthält. Der Hash $params kann folgende Optionen beinhalten:		Der Parameter $params ist eine Referenz auf eine Hash-Struktur, welche die einzelnen Parameter enthält. Der Hash $params kann folgende Optionen beinhalten:
Zeile 117:		Zeile 126:
	Beispiel zur Umwandlung eines Zeitstrings der lokalen Zeitzone in die koordinierte Weltzeit UTC mit Ausgabe im Log:		Beispiel zur Umwandlung eines Zeitstrings der lokalen Zeitzone in die koordinierte Weltzeit UTC mit Ausgabe im Log:

	:<~~source~~ lang="perl">		:<syntaxhighlight lang="perl">
	my $name = "xxx";		my $name = "xxx";
	...		...
Zeile 129:		Zeile 138:

	my ($err, $dtconv) = convertTimeZone ($params);		my ($err, $dtconv) = convertTimeZone ($params);
	</~~source~~>		</syntaxhighlight>

	Im Log wird ausgegeben:		Im Log wird ausgegeben:
Zeile 141:		Zeile 150:
	Die Konvertierung eines UTC-Zeitstrings in eine beliebige Zeitzone (siehe Funktion 'getTZNames') geschieht identisch, wobei in diesem Fall der Parameter tzcurrent den Wert 'UTC' enthalten muß:		Die Konvertierung eines UTC-Zeitstrings in eine beliebige Zeitzone (siehe Funktion 'getTZNames') geschieht identisch, wobei in diesem Fall der Parameter tzcurrent den Wert 'UTC' enthalten muß:

	:<~~source~~ lang="perl">		:<syntaxhighlight lang="perl">
	my $name = "xxx";		my $name = "xxx";
	...		...
Zeile 153:		Zeile 162:

	my ($err, $dtconv) = convertTimeZone ($params);		my ($err, $dtconv) = convertTimeZone ($params);
	</~~source~~>		</syntaxhighlight>

DS Starter: /* convertTimeZone */

2022-03-12T06:50:15Z

convertTimeZone

← Nächstältere Version		Version vom 12. März 2022, 08:50 Uhr
Zeile 86:		Zeile 86:
	</source>		</source>

	Der Parameter $params ist eine Referenz auf eine Hash-Struktur, welche die einzelnen Parameter enthält. Der Hash $~~param~~ kann folgende Optionen beinhalten:		Der Parameter $params ist eine Referenz auf eine Hash-Struktur, welche die einzelnen Parameter enthält. Der Hash $params kann folgende Optionen beinhalten:

DS Starter: /* convertTimeZone */

2022-03-11T22:42:52Z

convertTimeZone

← Nächstältere Version		Version vom 12. März 2022, 00:42 Uhr
Zeile 95:		Zeile 95:
	\| '''<code>name</code>''' \|\| nein \|\| "LogDB" \|\| Der Name des aufrufenden Device.		\| '''<code>name</code>''' \|\| nein \|\| "LogDB" \|\| Der Name des aufrufenden Device.
	\|-		\|-
	\| '''<code>dtstring</code>''' \|\| nein \|\| '2022-03-09 22:17:45' \|\| Der Original-Zeitstring der umgewandelt werden soll. Der Zeitstring kann auch Millisekunden enthalten. Die Form ist diesem Fall YYYY-MM-DD hh:mm:ss.xxx		\| '''<code>dtstring</code>''' \|\| nein \|\| '2022-03-09 22:17:45' \|\| Der Original-Zeitstring der umgewandelt werden soll. Der Zeitstring kann auch Millisekunden enthalten. Die Form ist diesem Fall YYYY-MM-DD hh:mm:ss.xxx
	\|-		\|-
	\| '''<code>tzcurrent</code>''' \|\| ja \|\| 'Europe/Berlin' \|\| Die Zeitzone des Original-Zeitstrings (dtstring). Es kann 'local' angegeben werden. In diesem Fall wird die Zeitzone des Systems versucht automatisch zu ermitteln. Das gilt ebenso wenn tzcurrent nicht angegeben ist.		\| '''<code>tzcurrent</code>''' \|\| ja \|\| 'Europe/Berlin' \|\| Die Zeitzone des Original-Zeitstrings (dtstring). Es kann 'local' angegeben werden. In diesem Fall wird die Zeitzone des Systems versucht automatisch zu ermitteln. Das gilt ebenso wenn tzcurrent nicht angegeben ist.

DS Starter: /* convertTimeZone */

2022-03-11T22:37:04Z

convertTimeZone

← Nächstältere Version		Version vom 12. März 2022, 00:37 Uhr
Zeile 86:		Zeile 86:
	</source>		</source>

	Der Parameter $~~param~~ ist eine Referenz auf eine Hash-Struktur, welche die einzelnen Parameter enthält. Der Hash $param kann folgende Optionen beinhalten:		Der Parameter $params ist eine Referenz auf eine Hash-Struktur, welche die einzelnen Parameter enthält. Der Hash $param kann folgende Optionen beinhalten: