<div id="readability-page-1" class="page"><article itemscope="" itemtype="http://schema.org/BlogPosting">

 

 <div itemprop="articleBody">
 ActiveRecord의 ORM을 이용하여 기간에 대한 쿼리를 사용하는 경우가 종종 있다.

<div><pre><code>range = Time.current.beginning_of_day..Time.current.end_of_day
Post.where(created_at: range)
</code></pre></div>

이렇게 시작 날짜와 종료 날자를 범위로 기준을 잡아 조회를 하게 되는데, 이 중 자주 사용할 법한 것들을 ActiveSupport 에서 지원해주는 헬퍼가 있다.

<h2 id="activesupport가-지원하는-헬퍼들">ActiveSupport가 지원하는 헬퍼들</h2>

<h3 id="all_day-doc">all_day() <a href="https://api.rubyonrails.org/classes/DateAndTime/Calculations.html#method-i-all_day)" rel="noreferrer" target="_blank">(Doc)</a></h3>

해당 날의 시작 시각 (00시 00분 00초)부터 해당 날의 마지막 시각 (23시 59분 59초)까지의 범위를 잡아준다.

이 메서드를 이용하면 처음 제시했던 코드는 아래와 같이 사용 할 수 있다.

<div><pre><code>Post.where(created_at: Time.current.all_day)
</code></pre></div>

<div><pre><code>Time.current.all_day
# =&gt; Sat, 26 Sep 2020 00:00:00 KST +09:00..Sat, 26 Sep 2020 23:59:59 KST +09:00
</code></pre></div>

<h3 id="all_weekstart_day--datebeginning_of_week-doc">all_week(start_day = Date.beginning_of_week) <a href="https://api.rubyonrails.org/classes/DateAndTime/Calculations.html#method-i-all_week)" rel="noreferrer" target="_blank">(Doc)</a></h3>

한 주간의 기간을 Range 로 반환한다.
해당하는 주의 첫날을 월요일로 할지 일요일로 할지도 전달인자를 통해 설정 할 수 있다. 예: all_week(:sunday)

<div><pre><code>1.week.ago.all_week
# =&gt; Mon, 14 Sep 2020 00:00:00 KST +09:00..Sun, 20 Sep 2020 23:59:59 KST +09:00

1.week.ago.all_week(:sunday)
# =&gt; Sun, 13 Sep 2020 00:00:00 KST +09:00..Sat, 19 Sep 2020 23:59:59 KST +09:00
</code></pre></div>

<h3 id="all_month-doc">all_month() <a href="https://api.rubyonrails.org/classes/DateAndTime/Calculations.html#method-i-all_month" rel="noreferrer" target="_blank">(Doc)</a></h3>

해당하는 달의 한달간의 기간을 반환한다. (9월일 경우 9월 1일부터 9월 30일까지)
참고로 2월이 윤년이라 29일인 해는 그것도 계산하여 반환하다.

<div><pre><code>Time.current.all_month

# =&gt; Tue, 01 Sep 2020 00:00:00 KST +09:00..Wed, 30 Sep 2020 23:59:59 KST +09:00
</code></pre></div>

<h3 id="all_year-doc">all_year() <a href="https://api.rubyonrails.org/classes/DateAndTime/Calculations.html#method-i-all_year" rel="noreferrer" target="_blank">(Doc)</a></h3>

해당하는 한 해의 기간을 반환한다. (1월 1일 00시부터 12월 31일 오후 11시 59분까지)

<div><pre><code>1.year.ago.all_year 
# =&gt; Tue, 01 Jan 2019 00:00:00 KST +09:00..Tue, 31 Dec 2019 23:59:59 KST +09:00
</code></pre></div>

<h3 id="all_quarter-doc">all_quarter() <a href="https://api.rubyonrails.org/classes/DateAndTime/Calculations.html#method-i-all_quarter" rel="noreferrer" target="_blank">(Doc)</a></h3>

해당하는 분기를 반환한다. 1~3월, 4~6월, 7~9월, 10월~ 12월의 분기에 대한 기간이 반환된다.

<div><pre><code>3.month.ago.all_quarter
# =&gt; Wed, 01 Apr 2020 00:00:00 KST +09:00..Tue, 30 Jun 2020 23:59:59 KST +09:00
</code></pre></div>

<h2 id="결론">결론</h2>

all_day의 구현체를 보면 결국 처음 우리가 사용한 문법과 동일하다.

헬퍼를 이용해도 실제 동작은 직접 호출하는 것과 다를 바 없겠지만, 훨씬 더 가독성 있게 접근할 수 있어서 편리하다.

<div><pre><code>def all_day
 beginning_of_day..end_of_day
end
</code></pre></div>

이외에도 날짜, 시간과 관련된 헬퍼 메서드들이 많으니 참고하면 좋다.

 </div>

</article></div>

Epilogue

ActiveRecord의 ORM을 이용하여 기간에 대한 쿼리를 사용하는 경우가 종종 있다.
range = Time.current.beginning_of_day..Time.current.end_of_day
Post.where(created_at: range)
이렇게 시작 날짜와 종료 날자를 범위로 기준을 잡아 조회를 하게 되는데, 이 중 자주 사용할 법한 것들을 ActiveSupport 에서 지원해주는 헬퍼가 있다.
ActiveSupport가 지원하는 헬퍼들
all_day() (Doc)
해당 날의 시작 시각 (00시 00분 00초)부터 해당 날의 마지막 시각 (23시 59분 59초)까지의 범위를 잡아준다.
이 메서드를 이용하면 처음 제시했던 코드는 아래와 같이 사용 할 수 있다.
Post.where(created_at: Time.current.all_day)
Time.current.all_day
# => Sat, 26 Sep 2020 00:00:00 KST +09:00..Sat, 26 Sep 2020 23:59:59 KST +09:00
all_week(start_day = Date.beginning_of_week) (Doc)
한 주간의 기간을 Range 로 반환한다.
해당하는 주의 첫날을 월요일로 할지 일요일로 할지도 전달인자를 통해 설정 할 수 있다. 예: all_week(:sunday)
1.week.ago.all_week
# => Mon, 14 Sep 2020 00:00:00 KST +09:00..Sun, 20 Sep 2020 23:59:59 KST +09:00
1.week.ago.all_week(:sunday)
# => Sun, 13 Sep 2020 00:00:00 KST +09:00..Sat, 19 Sep 2020 23:59:59 KST +09:00
all_month() (Doc)
해당하는 달의 한달간의 기간을 반환한다. (9월일 경우 9월 1일부터 9월 30일까지)
참고로 2월이 윤년이라 29일인 해는 그것도 계산하여 반환하다.
Time.current.all_month
# => Tue, 01 Sep 2020 00:00:00 KST +09:00..Wed, 30 Sep 2020 23:59:59 KST +09:00
all_year() (Doc)
해당하는 한 해의 기간을 반환한다. (1월 1일 00시부터 12월 31일 오후 11시 59분까지)
1.year.ago.all_year 
# => Tue, 01 Jan 2019 00:00:00 KST +09:00..Tue, 31 Dec 2019 23:59:59 KST +09:00
all_quarter() (Doc)
해당하는 분기를 반환한다. 1~3월, 4~6월, 7~9월, 10월~ 12월의 분기에 대한 기간이 반환된다.
3.month.ago.all_quarter
# => Wed, 01 Apr 2020 00:00:00 KST +09:00..Tue, 30 Jun 2020 23:59:59 KST +09:00
결론
all_day의 구현체를 보면 결국 처음 우리가 사용한 문법과 동일하다.
헬퍼를 이용해도 실제 동작은 직접 호출하는 것과 다를 바 없겠지만, 훨씬 더 가독성 있게 접근할 수 있어서 편리하다.
def all_day
  beginning_of_day..end_of_day
end
이외에도 날짜, 시간과 관련된 헬퍼 메서드들이 많으니 참고하면 좋다.

Ruby on Rails의 시간 범위 관련 헬퍼 메서드

댓글