File: date.rb

package info (click to toggle)
ruby-protocol-http 0.55.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 840 kB
  • sloc: ruby: 6,904; makefile: 4
file content (38 lines) | stat: -rw-r--r-- 1,130 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# frozen_string_literal: true

# Released under the MIT License.
# Copyright, 2023-2025, by Samuel Williams.

require "time"

module Protocol
	module HTTP
		module Header
			# The `date` header represents the date and time at which the message was originated.
			#
			# This header is typically included in HTTP responses and follows the format defined in RFC 9110.
			class Date < String
				# Replaces the current value of the `date` header with the specified value.
				#
				# @parameter value [String] the new value for the `date` header.
				def << value
					replace(value)
				end
				
				# Converts the `date` header value to a `Time` object.
				#
				# @returns [Time] the parsed time object corresponding to the `date` header value.
				def to_time
					::Time.parse(self)
				end
				
				# Whether this header is acceptable in HTTP trailers.
				# Date headers can safely appear in trailers as they provide metadata about response generation.
				# @returns [Boolean] `true`, as date headers are metadata that can be computed after response generation.
				def self.trailer?
					true
				end
			end
		end
	end
end