dateTimeLabelFormats (yAxis properties)

시간 축(type: "datetime")의 라벨 형식을 눈금 단위별로 설정합니다.
y값이 시각인 차트(예: 일별 출근 시각)에서 사용합니다. 형식 문자는 dateFormat 메서드와 같습니다.

Info

name type required(default) description
dateTimeLabelFormats object 선택 시간 축(type: "datetime")의 라벨 형식을 눈금 단위별로 설정합니다.
dateTimeLabelFormats.minute string 선택 분 단위 눈금 형식 (예: "%H:%M")
dateTimeLabelFormats.hour string 선택 시 단위 눈금 형식 (예: "%H시")
dateTimeLabelFormats.day string 선택 일 단위 눈금 형식 (예: "%Y-%m-%d")
dateTimeLabelFormats.month string 선택 월 단위 눈금 형식 (예: "%Y년 %m월")
dateTimeLabelFormats.year string 선택 연 단위 눈금 형식 (예: "%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

단위별 기본 형식

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

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

Example

myChart.setOptions({
  chart: {
    type: "column"
  },
  yAxis: {
    type: "datetime",
    min: Date.UTC(1970, 0, 1, 8),    // 08:00
    max: Date.UTC(1970, 0, 1, 10),   // 10:00
    tickInterval: 3600 * 1000,
    dateTimeLabelFormats: {
      hour: "%H시",        // 시 단위 눈금: 09시
      minute: "%H:%M"
    }
  },
  xAxis: {
    categories: ["월", "화", "수", "목"]
  },
  series: [{
    name: "출근 시각",
    data: [Date.UTC(1970, 0, 1, 8, 50), Date.UTC(1970, 0, 1, 9, 10), Date.UTC(1970, 0, 1, 8, 30), Date.UTC(1970, 0, 1, 9, 40)]
  }]
}, {
  append: true,
  redraw: true
});

제공 버전

version desc
7.3.0.0