datetimestamp

PlasmaCalcs.tools.history.datetimestamp(filepath, tz='local', *, as_str=False, sep='_')

return (best-effort guess of) datetime.datetime when this file was created or first written.

Result depends on system:

- macOS: real birth time

- Windows: real creation time

- Linux: falls back to modification time (st_mtime)

filepath : str

path to file

tz: ‘local’, ‘utc’, or datetime.tzinfo object

timezone to convert result to. ‘local’ –> machine’s local timezone.

‘utc’ –> standard/universal time (UTC) (“+00:00” if converted to str)

as_str : bool

whether to instead return as isoformat string using sep: YYYY-MM-DD_HH:MM:SS+HH:MM

sep: string

separator between date and time if as_str=True. (default ‘_’ shown in format above^)