libervia-backend: libervia/backend/tools/common/date

annotate libervia/backend/tools/common/date_utils.py @ 4306:94e0968987cd

plugin XEP-0033: code modernisation, improve delivery, data validation: - Code has been rewritten using Pydantic models and `async` coroutines for data validation and cleaner element parsing/generation. - Delivery has been completely rewritten. It now works even if server doesn't support multicast, and send to local multicast service first. Delivering to local multicast service first is due to bad support of XEP-0033 in server (notably Prosody which has an incomplete implementation), and the current impossibility to detect if a sub-domain service handles fully multicast or only for local domains. This is a workaround to have a good balance between backward compatilibity and use of bandwith, and to make it work with the incoming email gateway implementation (the gateway will only deliver to entities of its own domain). - disco feature checking now uses `async` corountines. `host` implementation still use Deferred return values for compatibility with legacy code. rel 450

author	Goffi <goffi@goffi.org>
date	Thu, 26 Sep 2024 16:12:01 +0200
parents	0d7bb4df2343
children

rev	line source
3028 ab2696e34d29 Python 3 port: Goffi <goffi@goffi.org> parents: 2825 diff changeset	1 #!/usr/bin/env python3
3137 559a625a236b fixed shebangs Goffi <goffi@goffi.org> parents: 3136 diff changeset	2
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	3
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	4 # SAT: a jabber client
3479 be6d91572633 date update Goffi <goffi@goffi.org> parents: 3137 diff changeset	5 # Copyright (C) 2009-2021 Jérôme Poisson (goffi@goffi.org)
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	6
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	7 # This program is free software: you can redistribute it and/or modify
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	8 # it under the terms of the GNU Affero General Public License as published by
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	9 # the Free Software Foundation, either version 3 of the License, or
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	10 # (at your option) any later version.
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	11
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	12 # This program is distributed in the hope that it will be useful,
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	15 # GNU Affero General Public License for more details.
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	16
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	17 # You should have received a copy of the GNU Affero General Public License
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	18 # along with this program. If not, see <http://www.gnu.org/licenses/>.
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	19
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	20 """tools to help manipulating time and dates"""
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	21
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	22 from typing import Union
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	23 import calendar
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	24 import datetime
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	25 import re
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	26 import time
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	27
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	28 from babel import dates
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	29 from dateutil import parser, tz
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	30 from dateutil.parser import ParserError
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	31 from dateutil.relativedelta import relativedelta
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	32 from dateutil.utils import default_tzinfo
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	33
4071 4b842c1fb686 refactoring: renamed `sat` package to `libervia.backend` Goffi <goffi@goffi.org> parents: 4029 diff changeset	34 from libervia.backend.core import exceptions
4b842c1fb686 refactoring: renamed `sat` package to `libervia.backend` Goffi <goffi@goffi.org> parents: 4029 diff changeset	35 from libervia.backend.core.constants import Const as C
4b842c1fb686 refactoring: renamed `sat` package to `libervia.backend` Goffi <goffi@goffi.org> parents: 4029 diff changeset	36 from libervia.backend.core.i18n import _
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	37
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	38 RELATIVE_RE = re.compile(
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	39 r"\s*(?P<in>\bin\b)?"
4088 4325a0f13b0f tools (common/date_utils): update date parsing regex: Goffi <goffi@goffi.org> parents: 4071 diff changeset	40 r"(?P<date>[^+-][^+]+[^\s+-])?\s(?P<direction>[-+])?\s"
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	41 r"\s(?P<quantity>\d+)\s"
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	42 r"(?P<unit>(second\|sec\|s\|minute\|min\|month\|mo\|m\|hour\|hr\|h\|day\|d\|week\|w\|year\|yr\|y))s?"
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	43 r"(?P<ago>\s+ago)?\s*",
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	44 re.I,
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	45 )
3599 ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	46 TIME_SYMBOL_MAP = {
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	47 "s": "second",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	48 "sec": "second",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	49 "m": "minute",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	50 "min": "minute",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	51 "h": "hour",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	52 "hr": "hour",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	53 "d": "day",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	54 "w": "week",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	55 "mo": "month",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	56 "y": "year",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	57 "yr": "year",
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	58 }
3028 ab2696e34d29 Python 3 port: Goffi <goffi@goffi.org> parents: 2825 diff changeset	59 YEAR_FIRST_RE = re.compile(r"\d{4}[^\d]+")
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	60 TZ_UTC = tz.tzutc()
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	61 TZ_LOCAL = tz.gettz()
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	62
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	63
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	64 def date_parse(value, default_tz=TZ_UTC):
2612 3e4e78de9cca tools (date_utils): moved date_parse to common.date_utils, because it can be used in frontends Goffi <goffi@goffi.org> parents: 2599 diff changeset	65 """Parse a date and return corresponding unix timestamp
3e4e78de9cca tools (date_utils): moved date_parse to common.date_utils, because it can be used in frontends Goffi <goffi@goffi.org> parents: 2599 diff changeset	66
2797 7968c8b7b5e1 tools (common): fixed dateutil.parser import Goffi <goffi@goffi.org> parents: 2771 diff changeset	67 @param value(unicode): date to parse, in any format supported by parser
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	68 @param default_tz(datetime.tzinfo): default timezone
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	69 @return (int): timestamp
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	70 """
3028 ab2696e34d29 Python 3 port: Goffi <goffi@goffi.org> parents: 2825 diff changeset	71 value = str(value).strip()
2825 1b6547fb80da tools(common/date_utils): fixed order on year first + set default date for date_parse Goffi <goffi@goffi.org> parents: 2797 diff changeset	72 dayfirst = False if YEAR_FIRST_RE.match(value) else True
1b6547fb80da tools(common/date_utils): fixed order on year first + set default date for date_parse Goffi <goffi@goffi.org> parents: 2797 diff changeset	73
3629 025ea418032f tools (common/date_utils): parse `now` alone (when used without relative delta) Goffi <goffi@goffi.org> parents: 3518 diff changeset	74 try:
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	75 dt = default_tzinfo(parser.parse(value, dayfirst=dayfirst), default_tz)
3629 025ea418032f tools (common/date_utils): parse `now` alone (when used without relative delta) Goffi <goffi@goffi.org> parents: 3518 diff changeset	76 except ParserError as e:
025ea418032f tools (common/date_utils): parse `now` alone (when used without relative delta) Goffi <goffi@goffi.org> parents: 3518 diff changeset	77 if value == "now":
025ea418032f tools (common/date_utils): parse `now` alone (when used without relative delta) Goffi <goffi@goffi.org> parents: 3518 diff changeset	78 dt = datetime.datetime.now(tz.tzutc())
025ea418032f tools (common/date_utils): parse `now` alone (when used without relative delta) Goffi <goffi@goffi.org> parents: 3518 diff changeset	79 else:
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	80 try:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	81 # the date may already be a timestamp
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	82 return int(value)
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	83 except ValueError:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	84 raise e
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	85 return calendar.timegm(dt.utctimetuple())
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	86
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	87
0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	88 def date_parse_ext(value: str, default_tz: datetime.tzinfo = TZ_UTC) -> float:
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	89 """Extended date parse which accept relative date
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	90
4185 c6d85c31a59f plugin ad-hoc registration: Implement plugin to handle registration links: Goffi <goffi@goffi.org> parents: 4088 diff changeset	91 @param value: date to parse, in any format supported by parser
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	92 and with the hability to specify X days/weeks/months/years in the past or future.
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	93 Relative date are specified either with something like `[main_date] +1 week`
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	94 or with something like `3 days ago`, and it is case insensitive. [main_date] is
2797 7968c8b7b5e1 tools (common): fixed dateutil.parser import Goffi <goffi@goffi.org> parents: 2771 diff changeset	95 a date parsable by parser, or empty to specify current date/time.
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	96 "now" can also be used to specify current date/time.
4185 c6d85c31a59f plugin ad-hoc registration: Implement plugin to handle registration links: Goffi <goffi@goffi.org> parents: 4088 diff changeset	97 @param default_tz: same as for date_parse
c6d85c31a59f plugin ad-hoc registration: Implement plugin to handle registration links: Goffi <goffi@goffi.org> parents: 4088 diff changeset	98 @return: timestamp
2612 3e4e78de9cca tools (date_utils): moved date_parse to common.date_utils, because it can be used in frontends Goffi <goffi@goffi.org> parents: 2599 diff changeset	99 """
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	100 m = RELATIVE_RE.match(value)
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	101 if m is None:
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	102 return date_parse(value, default_tz=default_tz)
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	103
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	104 if sum(1 for g in ("direction", "in", "ago") if m.group(g)) > 1:
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	105 raise ValueError(_('You can use only one of direction (+ or -), "in" and "ago"'))
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	106
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	107 if m.group("direction") == "-" or m.group("ago"):
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	108 direction = -1
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	109 else:
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	110 direction = 1
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	111
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	112 date = m.group("date")
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	113 if date is not None:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	114 date = date.strip()
3028 ab2696e34d29 Python 3 port: Goffi <goffi@goffi.org> parents: 2825 diff changeset	115 if not date or date == "now":
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	116 dt = datetime.datetime.now(tz.tzutc())
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	117 else:
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	118 try:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	119 dt = default_tzinfo(parser.parse(date, dayfirst=True), default_tz)
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	120 except ParserError as e:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	121 try:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	122 timestamp = int(date)
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	123 except ValueError:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	124 raise e
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	125 else:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	126 dt = datetime.datetime.fromtimestamp(timestamp, tz.tzutc())
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	127
3028 ab2696e34d29 Python 3 port: Goffi <goffi@goffi.org> parents: 2825 diff changeset	128 quantity = int(m.group("quantity"))
3599 ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	129 unit = m.group("unit").lower()
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	130 try:
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	131 unit = TIME_SYMBOL_MAP[unit]
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	132 except KeyError:
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	133 pass
ab1fe6b25631 tools (common/date_utils): accept more units (shortcuts) + fix timezone when date with relative delta is used Goffi <goffi@goffi.org> parents: 3518 diff changeset	134 delta_kw = {f"{unit}s": direction * quantity}
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	135 dt = dt + relativedelta(**delta_kw)
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	136 return calendar.timegm(dt.utctimetuple())
2612 3e4e78de9cca tools (date_utils): moved date_parse to common.date_utils, because it can be used in frontends Goffi <goffi@goffi.org> parents: 2599 diff changeset	137
3e4e78de9cca tools (date_utils): moved date_parse to common.date_utils, because it can be used in frontends Goffi <goffi@goffi.org> parents: 2599 diff changeset	138
4028 883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	139 def date_fmt(
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	140 timestamp: Union[float, int, str],
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	141 fmt: str = "short",
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	142 date_only: bool = False,
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	143 auto_limit: int = 7,
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	144 auto_old_fmt: str = "short",
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	145 auto_new_fmt: str = "relative",
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	146 locale_str: str = C.DEFAULT_LOCALE,
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	147 tz_info: Union[datetime.tzinfo, str] = TZ_UTC,
4028 883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	148 ) -> str:
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	149 """Format date according to locale
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	150
4028 883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	151 @param timestamp: unix time
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	152 @param fmt: one of:
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	153 - short: e.g. u'31/12/17'
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	154 - medium: e.g. u'Apr 1, 2007'
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	155 - long: e.g. u'April 1, 2007'
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	156 - full: e.g. u'Sunday, April 1, 2007'
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	157 - relative: format in relative time
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	158 e.g.: 3 hours
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	159 note that this format is not precise
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	160 - iso: ISO 8601 format
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	161 e.g.: u'2007-04-01T19:53:23Z'
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	162 - auto: use auto_old_fmt if date is older than auto_limit
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	163 else use auto_new_fmt
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	164 - auto_day: shorcut to set auto format with change on day
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	165 old format will be short, and new format will be time only
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	166 or a free value which is passed to babel.dates.format_datetime
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	167 (see http://babel.pocoo.org/en/latest/dates.html?highlight=pattern#pattern-syntax)
4028 883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	168 @param date_only: if True, only display date (not datetime)
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	169 @param auto_limit: limit in days before using auto_old_fmt
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	170 use 0 to have a limit at last midnight (day change)
4028 883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	171 @param auto_old_fmt: format to use when date is older than limit
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	172 @param auto_new_fmt: format to use when date is equal to or more recent
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	173 than limit
4028 883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	174 @param locale_str: locale to use (as understood by babel)
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	175 @param tz_info: time zone to use
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	176
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	177 """
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	178 timestamp = float(timestamp)
4028 883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	179 if isinstance(tz_info, str):
883db2790b11 tools (common/date_utils): let use a timezone name as str in `date_fmt` Goffi <goffi@goffi.org> parents: 3905 diff changeset	180 tz_info = tz.gettz(tz_info)
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	181 if fmt == "auto_day":
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	182 fmt, auto_limit, auto_old_fmt, auto_new_fmt = "auto", 0, "short", "HH:mm"
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	183 if fmt == "auto":
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	184 if auto_limit == 0:
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	185 now = datetime.datetime.now(tz_info)
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	186 # we want to use given tz_info, so we don't use date() or today()
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	187 today = datetime.datetime(
0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	188 year=now.year, month=now.month, day=now.day, tzinfo=now.tzinfo
0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	189 )
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	190 today = calendar.timegm(today.utctimetuple())
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	191 if timestamp < today:
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	192 fmt = auto_old_fmt
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	193 else:
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	194 fmt = auto_new_fmt
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	195 else:
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	196 days_delta = (time.time() - timestamp) / 3600
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	197 if days_delta > (auto_limit or 7):
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	198 fmt = auto_old_fmt
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	199 else:
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	200 fmt = auto_new_fmt
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	201
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	202 if fmt == "relative":
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	203 delta = timestamp - time.time()
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	204 return dates.format_timedelta(
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	205 delta, granularity="minute", add_direction=True, locale=locale_str
56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	206 )
3518 b258dce27d6d tools (common/date_utils): fix `date_only` for `short`, `long` and `full` format Goffi <goffi@goffi.org> parents: 3479 diff changeset	207 elif fmt in ("short", "long", "full"):
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	208 if date_only:
3518 b258dce27d6d tools (common/date_utils): fix `date_only` for `short`, `long` and `full` format Goffi <goffi@goffi.org> parents: 3479 diff changeset	209 dt = datetime.datetime.fromtimestamp(timestamp, tz_info)
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	210 return dates.format_date(dt, format=fmt, locale=locale_str)
3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	211 else:
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	212 return dates.format_datetime(
0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	213 timestamp, format=fmt, locale=locale_str, tzinfo=tz_info
0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	214 )
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	215 elif fmt == "iso":
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	216 if date_only:
2624 56f94936df1e code style reformatting using black Goffi <goffi@goffi.org> parents: 2612 diff changeset	217 fmt = "yyyy-MM-dd"
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	218 else:
5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	219 fmt = "yyyy-MM-ddTHH:mm:ss'Z'"
2703 3ba53b1cd1e6 tools (common/date_utils): date_parse_ext + timezone handling: Goffi <goffi@goffi.org> parents: 2624 diff changeset	220 return dates.format_datetime(timestamp, format=fmt)
2599 5b26033c49a8 tools (common): moved date_fmt function from template filters to new date_utils module, so it can be used everywhere. Goffi <goffi@goffi.org> parents: diff changeset	221 else:
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	222 return dates.format_datetime(
0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	223 timestamp, format=fmt, locale=locale_str, tzinfo=tz_info
0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	224 )
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	225
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	226
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	227 def delta2human(start_ts: Union[float, int], end_ts: Union[float, int]) -> str:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	228 """Convert delta of 2 unix times to human readable text
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	229
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	230 @param start_ts: timestamp of starting time
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	231 @param end_ts: timestamp of ending time
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	232 """
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	233 if end_ts < start_ts:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	234 raise exceptions.InternalError(
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	235 "end timestamp must be bigger or equal to start timestamp !"
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	236 )
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	237 rd = relativedelta(
4270 0d7bb4df2343 Reformatted code base using black. Goffi <goffi@goffi.org> parents: 4185 diff changeset	238 datetime.datetime.fromtimestamp(end_ts), datetime.datetime.fromtimestamp(start_ts)
3905 92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	239 )
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	240 text_elems = []
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	241 for unit in ("years", "months", "days", "hours", "minutes"):
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	242 value = getattr(rd, unit)
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	243 if value == 1:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	244 # we remove final "s" when there is only 1
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	245 text_elems.append(f"1 {unit[:-1]}")
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	246 elif value > 1:
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	247 text_elems.append(f"{value} {unit}")
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	248
92482cc80d0b tools (common/date_utils) handle timestamp and `in` + `delta2human`: Goffi <goffi@goffi.org> parents: 3631 diff changeset	249 return ", ".join(text_elems)
4029 432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	250
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	251
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	252 def get_timezone_name(tzinfo, timestamp: Union[float, int]) -> str:
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	253 """
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	254 Get the DST-aware timezone name for a given timezone and timestamp.
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	255
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	256 @param tzinfo: The timezone to get the name for
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	257 @param timestamp: The timestamp to use, as a Unix timestamp (number of seconds since
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	258 the Unix epoch).
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	259 @return: The DST-aware timezone name.
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	260 """
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	261
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	262 dt = datetime.datetime.fromtimestamp(timestamp)
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	263 dt_tz = dt.replace(tzinfo=tzinfo)
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	264 tz_name = dt_tz.tzname()
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	265 if tz_name is None:
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	266 raise exceptions.InternalError("tz_name should not be None")
432f7e422a27 tools (common/date_utils): new `get_timezone_name` to retrieve it from a tzinfo and a timestamp Goffi <goffi@goffi.org> parents: 4028 diff changeset	267 return tz_name

Mercurial > libervia-backend

annotate libervia/backend/tools/common/date_utils.py @ 4306:94e0968987cd