gamesheet_sdk.admin.cli.shared.datetime_helpers module

Backwards-compatible re-export of the shared datetime helpers.

The implementations moved to gamesheet_sdk.common.cli.datetime_helpers so that the common pillar no longer imports from admin; that inversion made common.cli.game_times unimportable from the teams CLI. This module is kept so existing admin.cli.shared imports keep working.

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:

str – 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:

int – 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.datetime preserving face values.

Uses dateutil.parser.parse for flexible input. Any timezone information is stripped — the returned datetime.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:

datetime.datetime – A timezone-naive datetime.datetime with the face-value time

Raises:

UsageError – If the string cannot be parsed

Return type:

datetime

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

Returns:

tuple[str, str] – (start_utc_iso, end_utc_iso) tuple

Raises:

UsageError – If fewer than 2 of 3 are provided, or if all 3 are inconsistent, or end <= start

Return type:

tuple[str, str]

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

• label (str) – "start" or "end", for error messages

Returns:

str | None – A merged datetime string or None

Raises:

UsageError – If only one of date/time is provided

Return type:

str | None

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)

Returns:

tuple[str, str] – (start_utc_iso, end_utc_iso) tuple

Return type:

tuple[str, str]

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.datetime) – Start datetime.datetime (UTC)

• end_dt (datetime.datetime) – End datetime.datetime (UTC)

Raises:

UsageError – If end <= start

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

• label (str) – "start" or "end", for error messages

Raises:

UsageError – If combined and any split input coexist