mirror of
https://github.com/jxxghp/MoviePilot.git
synced 2026-08-30 04:27:40 +08:00
112 lines
3.5 KiB
Python
112 lines
3.5 KiB
Python
"""日期、时间戳和时长的无状态转换能力。"""
|
|
|
|
import bisect
|
|
import datetime
|
|
from typing import Any, Optional, Union
|
|
|
|
import dateparser
|
|
import dateutil.parser
|
|
|
|
|
|
def format_approx_duration(seconds: Union[str, int, float]) -> str:
|
|
"""把秒数格式化为单一最大单位的近似时长。"""
|
|
try:
|
|
seconds = float(seconds)
|
|
except (TypeError, ValueError):
|
|
return ""
|
|
thresholds = [(0, "秒"), (60 - 1, "分"), (3600 - 1, "小时"), (86400 - 1, "天")]
|
|
index = bisect.bisect_left(
|
|
[threshold for threshold, _unit in thresholds], seconds
|
|
) - 1
|
|
if index == -1:
|
|
return str(seconds)
|
|
threshold, unit = thresholds[index]
|
|
return f"{round(seconds / (threshold + 1))}{unit}"
|
|
|
|
|
|
def format_duration(seconds: Union[str, int, float]) -> str:
|
|
"""把秒数格式化为时分秒组合文本。"""
|
|
hours = seconds // 3600
|
|
remainder_seconds = seconds % 3600
|
|
minutes = remainder_seconds // 60
|
|
seconds = remainder_seconds % 60
|
|
|
|
result = f"{int(seconds)}秒"
|
|
if minutes:
|
|
result = f"{int(minutes)}分{result}"
|
|
if hours:
|
|
result = f"{int(hours)}时{result}"
|
|
return result
|
|
|
|
|
|
def parse_datetime(value: Any) -> Optional[datetime.datetime]:
|
|
"""将常见日期表达解析为 datetime，无法解析时返回 None。"""
|
|
try:
|
|
return dateutil.parser.parse(value)
|
|
except (TypeError, ValueError, dateutil.parser.ParserError):
|
|
return None
|
|
|
|
|
|
def normalize_datetime(value: str) -> str:
|
|
"""把常见绝对或相对日期文本统一为本地日期时间格式。"""
|
|
if not value:
|
|
return value
|
|
try:
|
|
parsed = dateparser.parse(value)
|
|
return parsed.strftime("%Y-%m-%d %H:%M:%S") if parsed else value
|
|
except (TypeError, ValueError, OverflowError):
|
|
return value
|
|
|
|
|
|
def format_timestamp(timestamp: str, date_format: str = "%Y-%m-%d %H:%M:%S") -> str:
|
|
"""把 Unix 时间戳转换为指定格式的本地日期文本。"""
|
|
if isinstance(timestamp, str) and not timestamp.isdigit():
|
|
return timestamp
|
|
try:
|
|
return datetime.datetime.fromtimestamp(int(timestamp)).strftime(date_format)
|
|
except (TypeError, ValueError, OverflowError, OSError):
|
|
return timestamp
|
|
|
|
|
|
def parse_timestamp(value: str) -> float:
|
|
"""把日期表达转换为 Unix 时间戳，无法解析时返回零。"""
|
|
if not value:
|
|
return 0
|
|
try:
|
|
parsed = dateparser.parse(value)
|
|
return parsed.timestamp() if parsed else 0
|
|
except (TypeError, ValueError, OverflowError):
|
|
return 0
|
|
|
|
|
|
def format_minutes(minutes: int) -> str:
|
|
"""把分钟数格式化为小时和分钟组合文本。"""
|
|
if not minutes:
|
|
return ""
|
|
hours, remaining_minutes = divmod(minutes, 60)
|
|
if hours:
|
|
return f"{hours}小时{remaining_minutes}分"
|
|
return f"{remaining_minutes}分钟"
|
|
|
|
|
|
def format_remaining(value: str) -> str:
|
|
"""把本地日期时间文本格式化为距当前时间的剩余时长。"""
|
|
if not value:
|
|
return ""
|
|
try:
|
|
target = datetime.datetime.strptime(value, "%Y-%m-%d %H:%M:%S")
|
|
except ValueError:
|
|
return value
|
|
difference = target - datetime.datetime.now()
|
|
seconds = difference.seconds
|
|
days = difference.days
|
|
hours = seconds // 3600
|
|
minutes = (seconds % 3600) // 60
|
|
if days > 0:
|
|
return f"{days}天{hours}小时{minutes}分钟"
|
|
if hours > 0:
|
|
return f"{hours}小时{minutes}分钟"
|
|
if minutes > 0:
|
|
return f"{minutes}分钟"
|
|
return ""
|