---

Kolumna zegara światowego wyświetla aktualny czas w wybranej strefie czasowej. Jest często używana do śledzenia lokalnego czasu członków zespołu w rozproszonych zespołach.

Za pomocą API kolumna zegara światowego obsługuje odczyt, filtrowanie, tworzenie, aktualizowanie i czyszczenie wartości.

Typ kolumny	Typ implementacji	Obsługiwane operacje
world_clock	WorldClockValue	Odczyt: tak Filtrowanie: tak Tworzenie: tak Aktualizowanie: tak (tylko change_multiple_column_values) Czyszczenie: tak (tylko change_multiple_column_values)

---

Zapytania

Dane z kolumn zegara światowego możesz pobierać za pomocą pola column_values w obiekcie items, używając wbudowanego fragmentu dla WorldClockValue.

query {
  items(ids: [1234567890, 9876543210]) {
    name
    column_values {
      ... on WorldClockValue {
        id
        timezone
        text
        value
        updated_at
      }
    }
  }
}

const query = `
  query ($itemIds: [ID!]) {
    items(ids: $itemIds) {
      name
      column_values {
        ... on WorldClockValue {
          id
          timezone
          text
          value
          updated_at
        }
      }
    }
  }
`;

const variables = { itemIds: [1234567890, 9876543210] };

const response = await mondayApiClient.request(query, variables);

Pola

Użyj poniższych pól, aby określić, jakie informacje zwróci implementacja WorldClockValue.

Pole	Opis
column Column!	Kolumna, do której należy wartość.
id ID!	Unikalny identyfikator kolumny.
text String	Identyfikator strefy czasowej IANA w postaci tekstu (np. "Europe/London"). Zwraca "", jeśli pole jest puste.
timezone String	Identyfikator strefy czasowej IANA (np. "Europe/London", "America/New_York"). Zwraca null, jeśli nie ustawiono strefy czasowej.
type ColumnType!	Typ kolumny (world_clock).
updated_at Date	Data ostatniej aktualizacji wartości kolumny.
value JSON	Surowa wartość kolumny w postaci ciągu JSON.

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "name": "London Office",
        "column_values": [
          {
            "id": "world_clock",
            "timezone": "Europe/London",
            "text": "Europe/London",
            "value": "{\"timezone\":\"Europe/London\",\"changed_at\":\"2026-03-21T10:58:37.307Z\"}",
            "updated_at": "2026-03-21T10:58:37+00:00"
          }
        ]
      }
    ]
  }
}

---

Filtrowanie

Możesz filtrować elementy według wartości zegara światowego za pomocą obiektu items_page. Kolumna zegara światowego umożliwia filtrowanie według wyświetlanej nazwy strefy czasowej.

Operator	Wartość porównania	Opis
any_of	Tablica wyświetlanych nazw stref czasowych (np. ["London"])	Zwraca elementy, których zegar światowy pasuje do dowolnej z podanych nazw stref czasowych wyświetlanych w interfejsie monday.com.
not_any_of	Tablica wyświetlanych nazw stref czasowych (np. ["London"])	Pomija elementy, których zegar światowy pasuje do dowolnej z podanych nazw stref czasowych.
is_empty	[]	Zwraca elementy, dla których nie ustawiono strefy czasowej.
is_not_empty	[]	Zwraca elementy, dla których ustawiono strefę czasową.

Przykłady

Filtrowanie według strefy czasowej

Ten przykład zwraca wszystkie elementy, dla których zegar światowy jest ustawiony na „London”.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "world_clock"
            compare_value: ["London"]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
        column_values {
          ... on WorldClockValue {
            timezone
            text
          }
        }
      }
    }
  }
}

Filtrowanie według pustej wartości zegara światowego

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "world_clock"
            compare_value: []
            operator: is_empty
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

---

Mutacje

Tworzenie

Wymagany zakres uprawnień: boards:write

Mutacja create_column tworzy nową kolumnę zegara światowego za pomocą API.

mutation {
  create_column(
    board_id: 1234567890
    title: "Local Time"
    column_type: world_clock
  ) {
    id
    title
    type
  }
}

Aktualizowanie wartości

Możesz aktualizować kolumnę zegara światowego za pomocą change_multiple_column_values. Przekaż prawidłowy identyfikator strefy czasowej IANA w formacie Kontynent/Miasto (np. "Europe/London", "America/New_York", "Asia/Tokyo").

change_multiple_column_values

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"world_clock\": {\"timezone\": \"Europe/London\"}}"
  ) {
    id
    name
  }
}

const query = `
  mutation ($boardId: ID!, $itemId: ID!, $columnValues: JSON!) {
    change_multiple_column_values(
      board_id: $boardId
      item_id: $itemId
      column_values: $columnValues
    ) {
      id
      name
    }
  }
`;

const variables = {
  boardId: 1234567890,
  itemId: 9876543210,
  columnValues: JSON.stringify({
    world_clock: { timezone: "Europe/London" }
  })
};

const response = await mondayApiClient.request(query, variables);

Ustawianie zegara światowego podczas tworzenia elementu

Możesz ustawić strefę czasową podczas tworzenia elementu, przekazując wartość kolumny zegara światowego w argumencie column_values.

mutation {
  create_item(
    board_id: 1234567890
    item_name: "London Office"
    column_values: "{\"world_clock\": {\"timezone\": \"Europe/London\"}}"
  ) {
    id
    name
  }
}

Czyszczenie wartości

Możesz wyczyścić wartość kolumny zegara światowego za pomocą change_multiple_column_values, przekazując null.

mutation {
  change_multiple_column_values(
    item_id: 9876543210
    board_id: 1234567890
    column_values: "{\"world_clock\": null}"
  ) {
    id
    name
  }
}

---

Odczytywanie konfiguracji kolumny

Aby odczytać konfigurację kolumny zegara światowego, pobierz jej ustawienia za pomocą pola settings kolumny.

query {
  boards(ids: 1234567890) {
    columns(ids: ["world_clock"]) {
      id
      title
      settings
    }
  }
}

Struktura odpowiedzi settings

Pole settings zwraca typowany obiekt JSON z następującymi kluczami:

Klucz	Typ	Opis
format	string	Format wyświetlania czasu (np. "HH:mm" dla formatu 24-godzinnego lub "hh:mm A" dla formatu 12-godzinnego).
startWorkingHours	string	Początek godzin pracy jako ciąg znaków z liczbą ("0"–"23").
endWorkingHours	string	Koniec godzin pracy jako ciąg znaków z liczbą ("0"–"23").
show_utc_offset	boolean	Określa, czy obok godziny wyświetlać różnicę względem UTC.

Przykładowa odpowiedź settings

Gdy nie skonfigurowano ustawień niestandardowych:

{}

Gdy skonfigurowano ustawienia:

{
  "format": "hh:mm A",
  "startWorkingHours": "9",
  "endWorkingHours": "17",
  "show_utc_offset": true
}

---

Pobieranie schematu typu kolumny

Schemat JSON ustawień kolumny zegara światowego możesz pobrać programowo za pomocą zapytania get_column_type_schema. Zwraca ono strukturę, reguły walidacji i dostępne właściwości konfiguracji kolumny.

query {
  get_column_type_schema(
    type: world_clock
  )
}

{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Column specific settings",
            "properties": {
              "format": {
                "type": "string",
                "description": "Time display format string (e.g., HH:mm, hh:mm A)"
              },
              "startWorkingHours": {
                "type": "string",
                "description": "Start of working hours (0-23)",
                "enum": ["0", "1", "2", "...", "23"]
              },
              "endWorkingHours": {
                "type": "string",
                "description": "End of working hours (0-23)",
                "enum": ["0", "1", "2", "...", "23"]
              },
              "show_utc_offset": {
                "type": "boolean",
                "description": "Whether to show UTC offset alongside the time"
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  }
}

Odpowiedź zawiera nazwy właściwości, typy, ograniczenia (takie jak maksymalna długość i dozwolone wartości) oraz opisy poszczególnych ustawień. Możesz jej użyć do walidowania ustawień kolumny, dynamicznego generowania interfejsów użytkownika lub przekazywania kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.