1. Instance methods

created_time → String, Hash

created_time returns the created time value managed by Notion.

CreatedTimeProperty is read-only. It does not provide DateProperty-style setters such as start_date=, end_date=, time_zone=, or clear.

created_time of Page property generated from properties[] returns the created time by ISO8601 String.
created_time of Database or DataSource property generated from properties[] returns an empty Hash {}. The property schema has no timestamp value.

created_time of Page, Database, or DataSource object metadata returns the created time by ISO8601 String.

page.properties["CreatedTimeTitle"].created_time
=> "2022-03-10T04:13:00.000Z"
db.properties["CreatedTimeTitle"].created_time
=> {}
page.created_time.created_time
=> "2022-03-10T04:13:00.000Z"
ds.created_time.created_time
=> "2022-02-07T21:29:00.000Z"

DateBaseProperty filter methods

CreatedTimeProperty inherits date and timestamp filter methods from DateBaseProperty.

DateBaseProperty is a common base class for properties that support Notion date or timestamp filters. It does not mean that every subclass is a user-editable date property.

For CreatedTimeProperty, these methods create timestamp filters using "timestamp" => "created_time".

filter_after(value) → Query

[PARAM] value value for filter

filter_after creates a Query object for after filter.

> ds.created_time.filter_after Time.new(2022, 5, 4, 21, 30)
# => #<NotionRubyMapping::Query:0x000000011058def8 @filter={"timestamp"=>"created_time", "created_time"=>{"after"=>"2022-05-04T21:30:00+09:00"}}, @page_size=100, @sort=[], @start_cursor=nil>

### only RollupProperty
ds.properties["RollupTitle"].filter_after Date.new(2022, 5, 7), another_type: "date"
# => #<NotionRubyMapping::Query:0x0000000109241f58 @filter={"property"=>"RollupTitle", "date"=>{"after"=>"2022-05-07"}}, @page_size=100, @sort=[], @start_cursor=nil>

filter_before(value) → Query

[PARAM] value value for filter

filter_before creates a Query object for before filter.

ds.created_time.filter_before Time.new(2022, 5, 4, 21, 30)
# => #<NotionRubyMapping::Query:0x0000000110675cf8 @filter={"timestamp"=>"created_time", "created_time"=>{"before"=>"2022-05-04T21:30:00+09:00"}}, @page_size=100, @sort=[], @start_cursor=nil>

### only RollupProperty (date)
ds.properties["RollupTitle"].filter_before Date.new(2022, 5, 7), another_type: "date"
# => #<NotionRubyMapping::Query:0x00000001055804e8 @filter={"property"=>"RollupTitle", "date"=>{"before"=>"2022-05-07"}}, @page_size=100, @sort=[], @start_cursor=nil>

filter_does_not_equal(value) → Query

filter_equals(value) → Query

filter_on_or_after(value) → Query

[PARAM] value value for filter

filter_on_or_after creates a Query object for on_or_after filter.

ds.created_time.filter_on_or_after Time.new(2022, 5, 4, 21, 30)
# => #<NotionRubyMapping::Query:0x0000000110557880 @filter={"timestamp"=>"created_time", "created_time"=>{"on_or_after"=>"2022-05-04T21:30:00+09:00"}}, @page_size=100, @sort=[], @start_cursor=nil>

### only RollupProperty (date)
ds.properties["RollupTitle"].filter_on_or_after Date.new(2022, 5, 7), another_type: "date"
# => #<NotionRubyMapping::Query:0x0000000109378598 @filter={"property"=>"RollupTitle", "date"=>{"on_or_after"=>"2022-05-07"}}, @page_size=100, @sort=[], @start_cursor=nil>

filter_on_or_before(value) → Query

[PARAM] value value for filter

filter_on_or_before creates a Query object for on_or_before filter.

ds.created_time.filter_on_or_before Time.new(2022, 5, 4, 21, 30)
# => #<NotionRubyMapping::Query:0x0000000106e65f58 @filter={"timestamp"=>"created_time", "created_time"=>{"on_or_before"=>"2022-05-04T21:30:00+09:00"}}, @page_size=100, @sort=[], @start_cursor=nil>

### only RollupProperty (date)
ds.properties["RollupTitle"].filter_on_or_before Date.new(2022, 5, 7), another_type: "date"
# => #<NotionRubyMapping::Query:0x00000001090a9ec0 @filter={"property"=>"RollupTitle", "date"=>{"on_or_before"=>"2022-05-07"}}, @page_size=100, @sort=[], @start_cursor=nil>

filter_next_month → Query

filter_next_month creates a Query object for next_month filter.

ds.created_time.filter_next_month
=> #<NotionRubyMapping::Query:0x000000011040fea0 @filter={"timestamp"=>"created_time", "created_time"=>{"next_month"=>{}}}, @page_size=100, @sort=[], @start_cursor=nil>

filter_next_week → Query

filter_next_week creates a Query object for next_week filter.

ds.created_time.filter_next_week
# => #<NotionRubyMapping::Query:0x000000011053f2a8 @filter={"timestamp"=>"created_time", "created_time"=>{"next_week"=>{}}}, @page_size=100, @sort=[], @start_cursor=nil>

### only RollupProperty (date)
ds.properties["RollupTitle"].filter_next_week another_type: "date"
# => #<NotionRubyMapping::Query:0x00000001093497c0 @filter={"property"=>"RollupTitle", "date"=>{"next_week"=>{}}}, @page_size=100, @sort=[], @start_cursor=nil>