gamesheet_sdk.admin.cli.shared.datetime_helpers module

Datetime parsing and resolution helpers for CLI commands.

gamesheet_sdk.admin.cli.shared.datetime_helpers.get_local_timezone_name()

Get the local system timezone name (IANA format).

Returns the timezone name like ‘America/New_York’, ‘UTC’, etc. Falls back to ‘UTC’ if unable to determine.

Returns:

IANA timezone name

Return type:

str

gamesheet_sdk.admin.cli.shared.datetime_helpers.get_local_timezone_offset()

Get the local timezone offset in minutes from UTC.

Returns the offset as a signed integer (negative for west of UTC, positive for east). For example, EDT (UTC-4) returns -240.

Returns:

Timezone offset in minutes

Return type:

int

gamesheet_sdk.admin.cli.shared.datetime_helpers.parse_flexible_datetime(raw)

Parse a flexible datetime string into a naive datetime preserving face values.

Uses dateutil.parser.parse for flexible input. Any timezone information is stripped — the returned datetime contains the literal hour/minute/second the user typed. This matches GameSheet’s API behavior, which stores and displays time values as-is without timezone conversion.

Parameters:

raw (str) – A human-readable datetime string

Returns:

A timezone-naive datetime with the face-value time

Return type:

datetime

Raises:

click.UsageError – If the string cannot be parsed

gamesheet_sdk.admin.cli.shared.datetime_helpers.validate_no_input_conflict(combined, date_part, time_part, label)

Raise if combined and split inputs are both provided.

Parameters:

• combined (str | None) – The --start-datetime or --end-datetime value

• date_part (str | None) – The --start-date or --end-date value

• time_part (str | None) – The --start-time or --end-time value

:param label:"start" or "end", for error messages :type label: str :raises click.UsageError: If combined and any split input coexist

gamesheet_sdk.admin.cli.shared.datetime_helpers.resolve_datetime_input(combined, date_part, time_part, label)

Merge split date+time inputs into one string, or return combined.

Parameters:

• combined (str | None) – The --start-datetime or --end-datetime value

• date_part (str | None) – The --start-date or --end-date value

• time_part (str | None) – The --start-time or --end-time value

Return type:

str | None

:param label:"start" or "end", for error messages :type label: str :returns: A merged datetime string or None :rtype: str | None :raises click.UsageError: If only one of date/time is provided

gamesheet_sdk.admin.cli.shared.datetime_helpers.validate_end_after_start(start_dt, end_dt)

Raise if end is not strictly after start.

Parameters:

• start_dt (datetime) – Start datetime (UTC)

• end_dt (datetime) – End datetime (UTC)

Raises:

click.UsageError – If end <= start

gamesheet_sdk.admin.cli.shared.datetime_helpers.resolve_create_times(start_raw, end_raw, duration)

Resolve start/end for create: exactly 2 of 3 required.

Parameters:

• start_raw (str | None) – Raw start datetime string, or None

• end_raw (str | None) – Raw end datetime string, or None

• duration (int | None) – Duration in minutes, or None

Return type:

tuple[str, str]

:returns:(start_utc_iso, end_utc_iso) tuple :rtype: tuple[str, str] :raises click.UsageError: If fewer than 2 of 3 are provided, or if all 3 are inconsistent, or end <= start

gamesheet_sdk.admin.cli.shared.datetime_helpers.resolve_update_times(start_raw, end_raw, duration, current_start, current_end)

Resolve start/end for update: partial inputs OK.

Uses current game values as fallback when the user provides fewer than 2 inputs.

Parameters:

• start_raw (str | None) – New start datetime string, or None

• end_raw (str | None) – New end datetime string, or None

• duration (int | None) – Duration in minutes, or None

• current_start (str) – Current game start time (ISO 8601)

• current_end (str) – Current game end time (ISO 8601)

Return type:

tuple[str, str]

:returns:(start_utc_iso, end_utc_iso) tuple :rtype: tuple[str, str]