dateTimeLabelFormats (xAxis properties)

시간 축(type: "datetime")의 라벨 형식을 눈금 단위별로 설정합니다.
형식 문자는 dateFormat 메서드와 같습니다 (%Y 연, %m 월, %d 일, %H 시, %M 분 등).

Info

name type required(default) description
dateTimeLabelFormats object 선택 시간 축(type: "datetime")의 라벨 형식을 눈금 단위별로 설정합니다.
dateTimeLabelFormats.millisecond string 선택 밀리초 단위 눈금 형식 (예: "%H:%M:%S.%L")
dateTimeLabelFormats.second string 선택 초 단위 눈금 형식 (예: "%H:%M:%S")
dateTimeLabelFormats.minute string 선택 분 단위 눈금 형식 (예: "%H:%M")
dateTimeLabelFormats.hour string 선택 시 단위 눈금 형식 (예: "%H시")
dateTimeLabelFormats.day string 선택 일 단위 눈금 형식 (예: "%Y-%m-%d")
dateTimeLabelFormats.week string 선택 주 단위 눈금 형식 (예: "%Y-%m-%d 주")
dateTimeLabelFormats.month string 선택 월 단위 눈금 형식 (예: "%Y년 %m월")
dateTimeLabelFormats.year string 선택 연 단위 눈금 형식 (기본 %Y) (예: "%Y년")

형식 문자

형식 문자열 안의 % 문자가 날짜 값으로 바뀌고, 나머지 글자(년, -, :, 공백 등)는 그대로 표시됩니다. 예: "%Y년 %m월 %d일 (%a)" → 2025년 01월 05일 (일)

형식 문자 의미 예 (2025-01-05 일요일 14:07:09.045)
%Y 연도 4자리 2025
%y 연도 2자리 25
%m 월 2자리 01
%B 월 이름 (IBLANG의 months) 1월
%b 월 약자 (shortMonths) 1
%d 일 2자리 05
%e 일 (한 자리면 앞에 공백 한 칸) 5
%A 요일 (weekdays) 일요일
%a 요일 약자 (shortWeekdays) 일
%w 요일 숫자 (일요일 0 ~ 토요일 6) 0
%H 시 24시간 2자리 14
%k 시 24시간 (앞에 0 없음) 14
%I 시 12시간 2자리 02
%l 시 12시간 (앞에 0 없음) 2
%p AM/PM 표시 (대문자) PM
%P am/pm 표시 (소문자) pm
%M 분 2자리 07
%S 초 2자리 09
%L 밀리초 3자리 045

단위별 기본 형식

축의 눈금 간격에 맞는 단위가 선택됩니다. 지정하지 않은 단위는 아래 기본 형식으로 표시됩니다.

단위 사용되는 경우 기본 형식으로 표시되는 예
millisecond 눈금 간격이 밀리초 단위일 때 오후 02:07:09.045
second 눈금 간격이 초 단위일 때 오후 02:07:09
minute 눈금 간격이 분 단위일 때 오후 02:07
hour 눈금 간격이 시 단위일 때 오후 02:07
day 눈금 간격이 일 단위일 때 1월 5일
week 눈금 간격이 주 단위일 때 1월 5일
month 눈금 간격이 월 단위일 때 2025년 1월
year 눈금 간격이 연 단위일 때 2025

Example

myChart.setOptions({
  chart: {
    type: "line"
  },
  xAxis: {
    type: "datetime",
    dateTimeLabelFormats: {
      day: "%m/%d",     // 일 단위 눈금: 01/02
      month: "%Y년 %m월"
    }
  },
  series: [{
    name: "방문자",
    data: [
      [Date.UTC(2025, 0, 1), 120],
      [Date.UTC(2025, 0, 2), 150],
      [Date.UTC(2025, 0, 3), 90],
      [Date.UTC(2025, 0, 4), 180]
    ]
  }]
}, {
  append: true,
  redraw: true
});

제공 버전

version desc
7.3.0.0