Поделиться через


Рабочие дни (независимый издатель) (предварительная версия)

Служба рабочих дней. Она охватывает более 45 стран и 230 региональных календарей. Он также охватывает основные календари фондовой биржи. Качество данных является главным приоритетом. API предлагает актуальную информацию, следуя объявлениям правительства о изменениях в государственные праздники.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Tomasz Poszytek
URL https://aka.ms/poszytek
Адрес электронной почты tomasz@poszytek.eu
Метаданные соединителя
Publisher Tomasz Poszytek
Веб-сайт https://api.workingdays.org/
Политика конфиденциальности https://api.workingdays.org/1.2/privacy_policy.php
Категории Финансировать; Торговля

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Укажите ключ API. securestring Укажите ключ API. True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Анализировать

Анализ периода (предоставление start_date и end_date по заданному календарю, API реагирует на анализ периодов).

Вывод списка нерабочих дней

Вывод списка нерабочих дней (выходные дни, государственные праздники и пользовательские даты) между 2 датами.

Добавление выходных дней

Добавьте выходные дни к заданной дате.

Добавление общественных праздников

Добавьте дни, когда государственные праздники происходят до заданной даты.

Добавление рабочих дней

Добавьте (или удалите) любое количество рабочих дней к дате.

Добавление рабочих часов

Добавьте время работы в заданный период начала и времени.

Поиск почтового адреса

Иногда может потребоваться определить, какая конфигурация календаря относится к почтовому адресу данного клиента. Эта служба возвращает соответствующую country_code и конфигурацию для заданных почтовых объявлений.

Получение сведений о днях

Получите подробные сведения о конкретном дне.

Проверка квоты

Проверьте квоту левых дней, чтобы использовать в течение текущего месяца и доступной для следующего месяца.

Анализировать

Анализ периода (предоставление start_date и end_date по заданному календарю, API реагирует на анализ периодов).

Параметры

Имя Ключ Обязательно Тип Описание
Код страны
country_code True string

Код страны ISO (2 буквы).

Начальная дата
start_date True string

Дата начала (гггг-MM-DD)

Дата окончания
end_date True string

Дата окончания (гггг-MM-DD)

Время запуска
start_time string

Время начала (HH:MM)

Время окончания
end_time string

Время окончания (HH:MM)

Конфигурация
configuration string

Имя предварительной конфигурации регионального набора. Дополнительные сведения см. в документации.

Выходные
weekend string

Структура выходных данных. Воскресенье-понедельник-вторник-среда-четверг-пятница-суббота. Если выходные для вас воскресенье и понедельник, вы можете отправить: 11000000 Если выходные дни в субботу днем и воскресенье: 1000003

Время недели
week_times string

Структура рабочего расписания недели. Этот параметр полезен при вычислении рабочих часов за период. При использовании этот параметр переопределивает параметр week_hours.

Начальный шаблон
start_template string

Дата начала чередующегося шаблона недели (ГГГГ-MM-DD) Если вы определяете чередующееся расписание недельного шаблона, необходимо указать, какое воскресенье начинается шаблон.

Использование пользовательской конфигурации
use_custom_configuration boolean

Учитывайте собственную личную конфигурацию.

Идентификатор профиля
profile_id string

Если вы создали несколько профилей в пользовательской конфигурации, идентификатор используемого профиля. 6 символов.

Возвращаемое значение

Имя Путь Тип Описание
end_date
result.end_date string

Дата окончания

Все итого
result.days.total string

Всего дней в течение периода

Все понедельники
result.days.mondays string

Понедельники в течение периода

Все вторники
result.days.tuesdays string

Вторники в течение периода

Все среды
result.days.wednesdays string

Среда в течение периода

Все четвергы
result.days.thursdays string

Четверги в течение периода

Все пятницы
result.days.fridays string

Пятницы в течение периода

Все субботы
result.days.saturdays string

Субботы в течение периода

Все воскресенье
result.days.sundays string

Воскресенье в течение периода

Все часы
result.days.hours string

Часы в течение периода

Все рабочие итоги
result.working_days.total string

Всего рабочих дней в течение периода

Все рабочие понедельники
result.working_days.mondays string

Рабочие понедельники в течение периода

Все рабочие вторники
result.working_days.tuesdays string

Работа во вторник в течение периода

Все рабочие среды
result.working_days.wednesdays string

Рабочие среды в течение периода

Все рабочие четвергы
result.working_days.thursdays string

Работа в четверг в течение периода

Все рабочие пятницы
result.working_days.fridays string

Работа в пятницу в течение периода

Все рабочие субботы
result.working_days.saturdays string

Рабочие субботы в течение периода

Все рабочие воскресенье
result.working_days.sundays string

Рабочие воскресенье в течение периода

Все рабочие часы
result.working_days.work_hours string

Рабочие часы в течение периода

Все заработные платы
result.working_days.wages string

Заработная плата в течение периода

Всего выходных дней
result.weekend_days.total string

Всего выходных дней в течение периода

Все выходные дни в понедельник
result.weekend_days.mondays string

Выходные дни происходят в понедельник в течение периода

Все выходные дни во вторник
result.weekend_days.tuesdays string

Выходные дни происходят во вторник в течение периода

Все выходные дни в среду
result.weekend_days.wednesdays string

Выходные дни происходят в среду в течение периода

Все выходные дни в четверг
result.weekend_days.thursdays string

Выходные дни происходят в четверг в течение периода

Все выходные дни в пятницу
result.weekend_days.fridays string

Выходные дни происходят в пятницу в течение периода

Все выходные дни в субботу
result.weekend_days.saturdays string

Выходные дни происходят в субботу в течение периода

Все выходные дни в воскресенье
result.weekend_days.sundays string

Выходные дни происходят в воскресенье в течение периода

Государственные праздники
result.public_holidays object

Список государственных праздников

Вывод списка нерабочих дней

Вывод списка нерабочих дней (выходные дни, государственные праздники и пользовательские даты) между 2 датами.

Параметры

Имя Ключ Обязательно Тип Описание
Код страны
country_code True string

Код страны ISO (2 буквы).

Начальная дата
start_date True string

Дата начала (гггг-MM-DD)

Дата окончания
end_date True string

Дата окончания (гггг-MM-DD)

Конфигурация
configuration string

Имя предварительной конфигурации регионального набора. Дополнительные сведения см. в документации.

Выходные
weekend string

Структура выходных данных. Воскресенье-понедельник-вторник-среда-четверг-пятница-суббота. Если выходные для вас воскресенье и понедельник, вы можете отправить: 11000000 Если выходные дни в субботу днем и воскресенье: 1000003

Использование пользовательской конфигурации
use_custom_configuration boolean

Учитывайте собственную личную конфигурацию.

Идентификатор профиля
profile_id string

Если вы создали несколько профилей в пользовательской конфигурации, идентификатор используемого профиля. 6 символов.

Возвращаемое значение

Имя Путь Тип Описание
Нерабочие дни
result.non_working_days object

Список нерабочих дней.

Добавление выходных дней

Добавьте выходные дни к заданной дате.

Параметры

Имя Ключ Обязательно Тип Описание
Код страны
country_code True string

Код страны ISO (2 буквы).

Начальная дата
start_date True string

Дата начала (гггг-MM-DD)

Приращение
increment True string

Количество выходных дней, которые вы хотите добавить в дату начала (положительное или отрицательное целое число, но не нулевое).

Включить начало
include_start True boolean

Должно ли число включать start_date? Значение по умолчанию — «истина».

Конфигурация
configuration string

Имя предварительной конфигурации регионального набора. Дополнительные сведения см. в документации.

Выходные
weekend string

Структура выходных данных. Воскресенье-понедельник-вторник-среда-четверг-пятница-суббота. Если выходные для вас воскресенье и понедельник, вы можете отправить: 11000000 Если выходные дни в субботу днем и воскресенье: 1000003

Время недели
week_times string

Структура рабочего расписания недели. Этот параметр полезен при вычислении рабочих часов за период. При использовании этот параметр переопределивает параметр week_hours.

Начальный шаблон
start_template string

Дата начала чередующегося шаблона недели (ГГГГ-MM-DD) Если вы определяете чередующееся расписание недельного шаблона, необходимо указать, какое воскресенье начинается шаблон.

Использование пользовательской конфигурации
use_custom_configuration boolean

Учитывайте собственную личную конфигурацию.

Идентификатор профиля
profile_id string

Если вы создали несколько профилей в пользовательской конфигурации, идентификатор используемого профиля. 6 символов.

Возвращаемое значение

Имя Путь Тип Описание
end_date
result.end_date string

Дата окончания

Все итого
result.days.total string

Всего дней в течение периода

Все понедельники
result.days.mondays string

Понедельники в течение периода

Все вторники
result.days.tuesdays string

Вторники в течение периода

Все среды
result.days.wednesdays string

Среда в течение периода

Все четвергы
result.days.thursdays string

Четверги в течение периода

Все пятницы
result.days.fridays string

Пятницы в течение периода

Все субботы
result.days.saturdays string

Субботы в течение периода

Все воскресенье
result.days.sundays string

Воскресенье в течение периода

Все часы
result.days.hours string

Часы в течение периода

Все рабочие итоги
result.working_days.total string

Всего рабочих дней в течение периода

Все рабочие понедельники
result.working_days.mondays string

Рабочие понедельники в течение периода

Все рабочие вторники
result.working_days.tuesdays string

Работа во вторник в течение периода

Все рабочие среды
result.working_days.wednesdays string

Рабочие среды в течение периода

Все рабочие четвергы
result.working_days.thursdays string

Работа в четверг в течение периода

Все рабочие пятницы
result.working_days.fridays string

Работа в пятницу в течение периода

Все рабочие субботы
result.working_days.saturdays string

Рабочие субботы в течение периода

Все рабочие воскресенье
result.working_days.sundays string

Рабочие воскресенье в течение периода

Все рабочие часы
result.working_days.work_hours string

Рабочие часы в течение периода

Все заработные платы
result.working_days.wages string

Заработная плата в течение периода

Всего выходных дней
result.weekend_days.total string

Всего выходных дней в течение периода

Все выходные дни в понедельник
result.weekend_days.mondays string

Выходные дни происходят в понедельник в течение периода

Все выходные дни во вторник
result.weekend_days.tuesdays string

Выходные дни происходят во вторник в течение периода

Все выходные дни в среду
result.weekend_days.wednesdays string

Выходные дни происходят в среду в течение периода

Все выходные дни в четверг
result.weekend_days.thursdays string

Выходные дни происходят в четверг в течение периода

Все выходные дни в пятницу
result.weekend_days.fridays string

Выходные дни происходят в пятницу в течение периода

Все выходные дни в субботу
result.weekend_days.saturdays string

Выходные дни происходят в субботу в течение периода

Все выходные дни в воскресенье
result.weekend_days.sundays string

Выходные дни происходят в воскресенье в течение периода

Государственные праздники
result.public_holidays object

Список государственных праздников

Добавление общественных праздников

Добавьте дни, когда государственные праздники происходят до заданной даты.

Параметры

Имя Ключ Обязательно Тип Описание
Код страны
country_code True string

Код страны ISO (2 буквы).

Начальная дата
start_date True string

Дата начала (гггг-MM-DD)

Приращение
increment True string

Количество дней, которые вы хотите добавить в дату начала (положительное или отрицательное целое число, но не нулевое).

Включить начало
include_start True boolean

Должно ли число включать start_date? Значение по умолчанию — «истина».

Конфигурация
configuration string

Имя предварительной конфигурации регионального набора. Дополнительные сведения см. в документации.

Выходные
weekend string

Структура выходных данных. Воскресенье-понедельник-вторник-среда-четверг-пятница-суббота. Если выходные для вас воскресенье и понедельник, вы можете отправить: 11000000 Если выходные дни в субботу днем и воскресенье: 1000003

Время недели
week_times string

Структура рабочего расписания недели. Этот параметр полезен при вычислении рабочих часов за период. При использовании этот параметр переопределивает параметр week_hours.

Начальный шаблон
start_template string

Дата начала чередующегося шаблона недели (ГГГГ-MM-DD) Если вы определяете чередующееся расписание недельного шаблона, необходимо указать, какое воскресенье начинается шаблон.

Использование пользовательской конфигурации
use_custom_configuration boolean

Учитывайте собственную личную конфигурацию.

Идентификатор профиля
profile_id string

Если вы создали несколько профилей в пользовательской конфигурации, идентификатор используемого профиля. 6 символов.

Возвращаемое значение

Имя Путь Тип Описание
end_date
result.end_date string

Дата окончания

Все итого
result.days.total string

Всего дней в течение периода

Все понедельники
result.days.mondays string

Понедельники в течение периода

Все вторники
result.days.tuesdays string

Вторники в течение периода

Все среды
result.days.wednesdays string

Среда в течение периода

Все четвергы
result.days.thursdays string

Четверги в течение периода

Все пятницы
result.days.fridays string

Пятницы в течение периода

Все субботы
result.days.saturdays string

Субботы в течение периода

Все воскресенье
result.days.sundays string

Воскресенье в течение периода

Все часы
result.days.hours string

Часы в течение периода

Все рабочие итоги
result.working_days.total string

Всего рабочих дней в течение периода

Все рабочие понедельники
result.working_days.mondays string

Рабочие понедельники в течение периода

Все рабочие вторники
result.working_days.tuesdays string

Работа во вторник в течение периода

Все рабочие среды
result.working_days.wednesdays string

Рабочие среды в течение периода

Все рабочие четвергы
result.working_days.thursdays string

Работа в четверг в течение периода

Все рабочие пятницы
result.working_days.fridays string

Работа в пятницу в течение периода

Все рабочие субботы
result.working_days.saturdays string

Рабочие субботы в течение периода

Все рабочие воскресенье
result.working_days.sundays string

Рабочие воскресенье в течение периода

Все рабочие часы
result.working_days.work_hours string

Рабочие часы в течение периода

Все заработные платы
result.working_days.wages string

Заработная плата в течение периода

Всего выходных дней
result.weekend_days.total string

Всего выходных дней в течение периода

Все выходные дни в понедельник
result.weekend_days.mondays string

Выходные дни происходят в понедельник в течение периода

Все выходные дни во вторник
result.weekend_days.tuesdays string

Выходные дни происходят во вторник в течение периода

Все выходные дни в среду
result.weekend_days.wednesdays string

Выходные дни происходят в среду в течение периода

Все выходные дни в четверг
result.weekend_days.thursdays string

Выходные дни происходят в четверг в течение периода

Все выходные дни в пятницу
result.weekend_days.fridays string

Выходные дни происходят в пятницу в течение периода

Все выходные дни в субботу
result.weekend_days.saturdays string

Выходные дни происходят в субботу в течение периода

Все выходные дни в воскресенье
result.weekend_days.sundays string

Выходные дни происходят в воскресенье в течение периода

Государственные праздники
result.public_holidays object

Список государственных праздников

Добавление рабочих дней

Добавьте (или удалите) любое количество рабочих дней к дате.

Параметры

Имя Ключ Обязательно Тип Описание
Код страны
country_code True string

Код страны ISO (2 буквы).

Начальная дата
start_date True string

Дата начала (гггг-MM-DD)

Приращение
increment True string

Количество рабочих дней, которые вы хотите добавить в дату начала (положительное или отрицательное целое число, но не нулевое).

Включить начало
include_start True boolean

Должно ли число включать start_date? Значение по умолчанию — «истина».

Конфигурация
configuration string

Имя предварительной конфигурации регионального набора. Дополнительные сведения см. в документации.

Выходные
weekend string

Структура выходных данных. Воскресенье-понедельник-вторник-среда-четверг-пятница-суббота. Если выходные для вас воскресенье и понедельник, вы можете отправить: 11000000 Если выходные дни в субботу днем и воскресенье: 1000003

Время недели
week_times string

Структура рабочего расписания недели. Этот параметр полезен при вычислении рабочих часов за период. При использовании этот параметр переопределивает параметр week_hours.

Начальный шаблон
start_template string

Дата начала чередующегося шаблона недели (ГГГГ-MM-DD) Если вы определяете чередующееся расписание недельного шаблона, необходимо указать, какое воскресенье начинается шаблон.

Использование пользовательской конфигурации
use_custom_configuration boolean

Учитывайте собственную личную конфигурацию.

Идентификатор профиля
profile_id string

Если вы создали несколько профилей в пользовательской конфигурации, идентификатор используемого профиля. 6 символов.

Возвращаемое значение

Имя Путь Тип Описание
end_date
result.end_date string

Дата окончания

Все итого
result.days.total string

Всего дней в течение периода

Все понедельники
result.days.mondays string

Понедельники в течение периода

Все вторники
result.days.tuesdays string

Вторники в течение периода

Все среды
result.days.wednesdays string

Среда в течение периода

Все четвергы
result.days.thursdays string

Четверги в течение периода

Все пятницы
result.days.fridays string

Пятницы в течение периода

Все субботы
result.days.saturdays string

Субботы в течение периода

Все воскресенье
result.days.sundays string

Воскресенье в течение периода

Все часы
result.days.hours string

Часы в течение периода

Все рабочие итоги
result.working_days.total string

Всего рабочих дней в течение периода

Все рабочие понедельники
result.working_days.mondays string

Рабочие понедельники в течение периода

Все рабочие вторники
result.working_days.tuesdays string

Работа во вторник в течение периода

Все рабочие среды
result.working_days.wednesdays string

Рабочие среды в течение периода

Все рабочие четвергы
result.working_days.thursdays string

Работа в четверг в течение периода

Все рабочие пятницы
result.working_days.fridays string

Работа в пятницу в течение периода

Все рабочие субботы
result.working_days.saturdays string

Рабочие субботы в течение периода

Все рабочие воскресенье
result.working_days.sundays string

Рабочие воскресенье в течение периода

Все рабочие часы
result.working_days.work_hours string

Рабочие часы в течение периода

Все заработные платы
result.working_days.wages string

Заработная плата в течение периода

Всего выходных дней
result.weekend_days.total string

Всего выходных дней в течение периода

Все выходные дни в понедельник
result.weekend_days.mondays string

Выходные дни происходят в понедельник в течение периода

Все выходные дни во вторник
result.weekend_days.tuesdays string

Выходные дни происходят во вторник в течение периода

Все выходные дни в среду
result.weekend_days.wednesdays string

Выходные дни происходят в среду в течение периода

Все выходные дни в четверг
result.weekend_days.thursdays string

Выходные дни происходят в четверг в течение периода

Все выходные дни в пятницу
result.weekend_days.fridays string

Выходные дни происходят в пятницу в течение периода

Все выходные дни в субботу
result.weekend_days.saturdays string

Выходные дни происходят в субботу в течение периода

Все выходные дни в воскресенье
result.weekend_days.sundays string

Выходные дни происходят в воскресенье в течение периода

Государственные праздники
result.public_holidays object

Список государственных праздников

Добавление рабочих часов

Добавьте время работы в заданный период начала и времени.

Параметры

Имя Ключ Обязательно Тип Описание
Код страны
country_code True string

Код страны ISO (2 буквы).

Начальная дата
start_date True string

Дата начала (гггг-MM-DD)

Время запуска
start_time True string

Время начала (HH:MM)

Время увеличения
increment_time True string

Время работы, которое необходимо добавить (или удалить) в время начала даты начала. Формат: H:i

Конфигурация
configuration string

Имя предварительной конфигурации регионального набора. Дополнительные сведения см. в документации.

Выходные
weekend string

Структура выходных данных. Воскресенье-понедельник-вторник-среда-четверг-пятница-суббота. Если выходные для вас воскресенье и понедельник, вы можете отправить: 11000000 Если выходные дни в субботу днем и воскресенье: 1000003

Время недели
week_times string

Структура рабочего расписания недели. Этот параметр полезен при вычислении рабочих часов за период. При использовании этот параметр переопределивает параметр week_hours.

Начальный шаблон
start_template string

Дата начала чередующегося шаблона недели (ГГГГ-MM-DD) Если вы определяете чередующееся расписание недельного шаблона, необходимо указать, какое воскресенье начинается шаблон.

Использование пользовательской конфигурации
use_custom_configuration boolean

Учитывайте собственную личную конфигурацию.

Идентификатор профиля
profile_id string

Если вы создали несколько профилей в пользовательской конфигурации, идентификатор используемого профиля. 6 символов.

Возвращаемое значение

Имя Путь Тип Описание
Дата окончания
result.end_date string

Вычисляемая дата окончания.

Время окончания
result.end_time string

Вычисляемое время окончания.

Поиск почтового адреса

Иногда может потребоваться определить, какая конфигурация календаря относится к почтовому адресу данного клиента. Эта служба возвращает соответствующую country_code и конфигурацию для заданных почтовых объявлений.

Параметры

Имя Ключ Обязательно Тип Описание
Address
address True string

Почтовый адрес. Это строка без ограничений.

Возвращаемое значение

Имя Путь Тип Описание
Состояние
result.status string

Состояние адреса

Код страны
result.country_code string

Код страны ISO.

Конфигурация
result.configuration string

Адрес дополнительных сведений.

Форматированный адрес
result.formatted_address string

Возвращен отформатированный адрес.

Получение сведений о днях

Получите подробные сведения о конкретном дне.

Параметры

Имя Ключ Обязательно Тип Описание
Код страны
country_code True string

Код страны ISO (2 буквы).

Date
date True string

Дата анализа (гггг-MM-DD)

Конфигурация
configuration string

Имя предварительной конфигурации регионального набора. Дополнительные сведения см. в документации.

Выходные
weekend string

Структура выходных данных. Воскресенье-понедельник-вторник-среда-четверг-пятница-суббота. Если выходные для вас воскресенье и понедельник, вы можете отправить: 11000000 Если выходные дни в субботу днем и воскресенье: 1000003

Использование пользовательской конфигурации
use_custom_configuration boolean

Учитывайте собственную личную конфигурацию.

Идентификатор профиля
profile_id string

Если вы создали несколько профилей в пользовательской конфигурации, идентификатор используемого профиля. 6 символов.

Возвращаемое значение

Имя Путь Тип Описание
Рабочий день
result.working_day string

Это рабочий день (0 означает нет).

Рабочие часы
result.work_hours string

Количество рабочих часов в этот день.

Зарплата
result.wages string

Зарплата

Утро начала
result.morning_start string

Время начала утра

Утро окончания
result.morning_end string

Время окончания утра

Начало дня
result.afternoon_start string

Время начала дня

Конец дня
result.afternoon_end string

Время окончания дня

Общественный праздник
result.public_holiday string

Это общественный праздник (0 означает нет).

Описание общественного праздника
result.public_holiday_description string

Описание этого общественного праздника

Выходные дни
result.weekend_day string

Это в выходные дни (0 означает нет).

настраиваемая дата.
result.custom_date string

Это настраиваемая дата (0 означает нет).

Пользовательское описание даты
result.custom_date_description string

Описание этой пользовательской даты.

Пользовательский цвет даты
result.custom_date_color string

Цвет, определенный для этой пользовательской даты.

Проверка квоты

Проверьте квоту левых дней, чтобы использовать в течение текущего месяца и доступной для следующего месяца.

Возвращаемое значение

Имя Путь Тип Описание
Государство
result.state string

Состояние плана (1:active, 2:отменено, -1:error).

Current
result.current string

Текущая квота (оставшиеся дни для анализа в течение этого месяца).

Next
result.next string

Квота доступна в следующем месяце.