Dayjs 사용법

[Dayjs란] 

Dayjs는 날짜 처리를 간편하게 할 수 있도록 도와주는 라이브러리이다. 일반적인 포매팅부터 날짜를 어느 기준만큼 더하고 빼는 등의 날짜연산과도 관련된 다양한 기능을 제공해준다.

 

[dayjs 객체 초기화]

dayjs()에 빈 값을 전달하면 현재 날짜 및 시간 기준으로 dayjs 객체가 생성된다. 

dayjs();

특정 날짜 및 시간을 기준으로 dayjs 객체를 생성하는 경우 Format String을 전달합니다.

dayjs('2023-08-17');
dayjs('2023-08-17 20:20:30');

 

[dayjs 객체 get] 

 

▶ 시/분/초/밀리초 가져오기 

// 시간 가져오기
dayjs().hour();
dayjs().get('hour');
dayjs().get('h');

// 분 가져오기
dayjs().minute();
dayjs().get('minute');
dayjs().get('m');

// 초 가져오기
dayjs().second();
dayjs().get('second');
dayjs().get('s');

// 밀리초 가져오기
dayjs().millisecond();
dayjs().get('millisecond');
dayjs().get('ms');

 

▶ 년 / 월 / 일 / 요일

// 년 가져오기
dayjs().year());
dayjs().get('year');
dayjs().get('y');

// 월 가져오기
dayjs().month());
dayjs().get('month');
dayjs().get('M');

// 일 가져오기
dayjs().date());
dayjs().get('date');
dayjs().get('D');

// 요일 가져오기
// 일요일(0) ~ 토요일(6)
dayjs().day());
dayjs().get('day');
dayjs().get('d');

 

 

[dayjs 객체 set] 

 

▶ 시 / 분 / 초 / 밀리초 

set() 함수의 첫 번째 인수는 단위를 두 번째 인수는 값을 넣는다. 

// 시간 설정
dayjs().set('h', 10);
dayjs().set('hour', 10);

// 분 설정
dayjs().set('m', 20);
dayjs().set('minute', 20);

// 초 설정
dayjs().set('s', 40);
dayjs().set('second', 40);

// 밀리초 설정
dayjs().set('ms', 100);
dayjs().set('millisecond', 100);

 

▶ 년 / 월 / 일 / 요일

// 년도 설정
dayjs().set('y', 2020);
dayjs().set('year', 2020);

// 월 설정
dayjs().set('M', 5);
dayjs().set('month', 5);

// 일 설정
dayjs().set('D', 25);
dayjs().set('date', 25);

// 요일 설정
dayjs().set('d', 4);
dayjs().set('day', 4);

 

[dayjs 객체 조작]

 

▶ 날짜 및 시간 더하기, 빼기

dayjs 객체에 날짜 및 시간을 더하는 경우 add() 함수를 사용하고 빼는 경우에는 substract() 함수를 사용한다.

// 년도 더하기, 빼기
dayjs().add(1, 'year');
dayjs().substract(1, 'year');

// 월 더하기, 빼기
dayjs().add(1, 'month');
dayjs().substract(1, 'month');

// 일 더하기, 빼기
dayjs().add(1, 'day');
dayjs().substract(1, 'day');

// 시간 더하기, 빼기
dayjs().add(1, 'hour');
dayjs().substract(1, 'hour');

// 분 더하기, 빼기
dayjs().add(1, 'minute');
dayjs().substract(1, 'minute');

// 초 더하기, 빼기
dayjs().add(1, 'second');
dayjs().substract(1, 'second');

 

[Format 및 Differ]

 

▶ Format

format() 함수는 dayjs 객체를 지정된 형식으로 Formatting 된 날짜 문자열을 반환한다. 

dayjs().format('YYYY-MM-DD hh:mm:ss');
dayjs().format('DD/MM/YYYY');

 

▶ 차이 값

diff() 함수를 사용하여 주어진 날짜 사이의 차이 값을 얻을 수 있다. 첫 번째 인수를 생략하면 밀리초 단위로 값을 반환하며, 밀리초 단위가 아닌 차이 값을 받기 위해서는 두 번째 인수에 단위를 전달해야한다. 또한, 소수점 숫자까지 원하는 경우 세 번째 인수로 true를 전달한다. 

dayjs('2023-12-31').diff('2023-01-01', 'day');
// 365

 

[dayjs 날짜 구별하기]

 

▶ 이전인지

isBefore() 함수로 이전 날짜인지 확인합니다.

dayjs('2023–08–17').isBefore('2023–08–01');
// false

dayjs('2023–08–17').isBefore('2023–09–01');
// true

 

▶ 동일한지

isSame() 함수로 두 날짜가 동일한지 확인합니다.

dayjs('2023–08–17').isSame('2023–08–17');
// true

dayjs('2023–08–17').isSame('2020–08–17');
// false

 

▶ 이후인지

isAfter() 함수로 이후 날짜인지 확인합니다.

dayjs('2023–08–17').isAfter('2023–08–01');
// true

dayjs('2023–08–17').isAfter('2023–08–31');
// false

 

▶ 두 날짜 사이인지 

isBetween() 함수를 사용하여 dayjs의 객체가 둘 날짜 사이에 존재하는지 확인할 수 있다. isBetween() 함수를 사용하기 위해서는 isBetween 플러그인이 설치되어야 한다.

dayjs('2023–08–17').isBetween('2021–01–01', '2023-08-30');
// true

dayjs('2023–08–17').isBetween('2023–08–20', '2023-08-31');
// false

 

▶ Date 객체인지

isValid() 함수를 사용하여 dayjs 객체에 할당된 값이 Date 객체인이 확인한다.

dayjs(new Date()).isValid();
// true