Days

날짜 관련 정보를 제공하는 서비스입니다.

대한민국 잡절 조회 서비스
월별 잡절 정보를 리턴합니다.(단오, 한식, 정월대보름)
End Point Method Parameter
/v1/days/inquiry/kr-sundryday GET Query

Request Parameters
필드 설명 타입
search_month 조회년월 String

Response
필드 설명 타입
dateName 잡절이름 String
locdate 날짜 String
dateKind 특일코드(04 : 잡절) String
isHoliday 휴일여부 String
seq 순번 Long

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 2,
    "list": [
      {
        "dateName": "말복",
        "locdate": 20230810,
        "dateKind": "04",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "칠석",
        "locdate": 20230822,
        "dateKind": "04",
        "isHoliday": "N",
        "seq": 1
      }
    ]
  }
}
대한민국 공휴일 조회 서비스
월별 (대체)공휴일 정보를 리턴합니다.(공휴일으로 지정 되지 않은 토,일요일 제외)
End Point Method Parameter
/v1/days/inquiry/kr-restday GET Query

Request Parameters
필드 설명 타입
search_month 조회년월 String

Response
필드 설명 타입
dateName 잡절이름 String
locdate 날짜 String
dateKind 특일코드(01 : 공휴일) String
isHoliday 휴일여부 String
seq 순번 Long

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 3,
    "list": [
      {
        "dateName": "어린이날",
        "locdate": 20230505,
        "dateKind": "01",
        "isHoliday": "Y",
        "seq": 1
      },
      {
        "dateName": "부처님오신날",
        "locdate": 20230527,
        "dateKind": "01",
        "isHoliday": "Y",
        "seq": 1
      },
      {
        "dateName": "대체공휴일",
        "locdate": 20230529,
        "dateKind": "01",
        "isHoliday": "Y",
        "seq": 1
      }
    ]
  }
}
대한민국 국경일 조회 서비스
월별 국경일 정보를 리턴합니다.(어린이 날, 광복절, 개천절) 제헌절은 국경일 이지만 공휴일이 아니기 때문에 isHoliday=N으로 리턴됩니다.
End Point Method Parameter
/v1/days/inquiry/kr-holiday GET Query

Request Parameters
필드 설명 타입
search_month 조회년월 String

Response
필드 설명 타입
dateName 잡절이름 String
locdate 날짜 String
dateKind 특일코드(01 : 국경일) String
isHoliday 휴일여부 String
remarks 비고 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 1,
    "list": [
      {
        "dateName": "제헌절",
        "locdate": 20230717,
        "dateKind": "01",
        "isHoliday": "N",
        "remarks": "국경일이지만 공휴일 아님",
        "seq": 1
      }
    ]
  }
}
대한민국 기념일 조회 서비스
월별 기념일 정보를 리턴합니다.(의병의 날, 정보보호의 날, 4·19 혁명 기념일)
End Point Method Parameter
/v1/days/inquiry/kr-anniversary GET Query

Request Parameters
필드 설명 타입
search_month 조회년월 String

Response
필드 설명 타입
dateName 잡절이름 String
locdate 날짜 String
dateKind 특일코드(02 : 기념일) String
isHoliday 휴일여부 String
seq 순번 Long

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 12,
    "list": [
      {
        "dateName": "4·3희생자 추념일",
        "locdate": 20230403,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "식목일",
        "locdate": 20230405,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "예비군의 날",
        "locdate": 20230407,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "보건의 날",
        "locdate": 20230407,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 2
      },
      {
        "dateName": "도시농업의 날",
        "locdate": 20230411,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "대한민국임시정부 수립기념일",
        "locdate": 20230411,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 2
      },
      {
        "dateName": "4·19 혁명 기념일",
        "locdate": 20230419,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "장애인의 날",
        "locdate": 20230420,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "과학의 날",
        "locdate": 20230421,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "정보통신의 날",
        "locdate": 20230422,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "법의 날",
        "locdate": 20230425,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      },
      {
        "dateName": "충무공 이순신 탄신일",
        "locdate": 20230428,
        "dateKind": "02",
        "isHoliday": "N",
        "seq": 1
      }
    ]
  }
}
대한민국 24절기 조회 서비스
월별 24절기 정보를 리턴합니다.(청명, 경칩, 하지)
End Point Method Parameter
/v1/days/inquiry/kr-24division GET Query

Request Parameters
필드 설명 타입
search_month 조회년월 String

Response
필드 설명 타입
dateName 잡절이름 String
locdate 날짜 String
dateKind 특일코드(03 : 절기) String
isHoliday 휴일여부 String
kst 한국표준시각 Long
seq 순번 Long

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 2,
    "list": [
      {
        "dateName": "대설",
        "locdate": 20231207,
        "dateKind": "03",
        "isHoliday": "N",
        "kst": "1833      ",
        "seq": 1
      },
      {
        "dateName": "동지",
        "locdate": 20231222,
        "dateKind": "03",
        "isHoliday": "N",
        "kst": "1227      ",
        "seq": 1
      }
    ]
  }
}
영업일 계산기 서비스
기준일에 휴일을 제외한 N일 이후의 날짜를 영업일로만 계산합니다. 예) 2023/12/22 기준으로 2영업일 후의 날짜는 23일~25일까지 휴일이므로 2023/12/27이 됩니다.(구분자를 '/'로 요청시)
End Point Method Parameter
/v1/days/inquiry/kr-businessday GET Query

Request Parameters
필드 설명 타입
creteria_day 기준일 String
add_day N일(1~100) String

Response
필드 설명 타입
calculated_day 계산된 영업일 Long

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "creteria_day" : "20230501",
    "add_day" : "5",
    "calculated_day" : 20230509
  }
}