icalendar 0.96.4 → 0.97

data/README

@@ -30,68 +30,86 @@ transport such as infrared might also be used.
 
 Now for some examples:
 
-* Creating iCalendars.
+## Probably want to start with this
 
-   # Create a calendar with a single event (Method 1)
-   cal = Icalendar::Calendar.new
-   event = Icalendar::Event.new
-  
-   # Set some properties for this event
-   event.user_id = "joe-bob@somewhere.net"
-   event.timestamp = DateTime.now 
-   event.start = Date.new(2005, 04, 29)
-   event.end = Date.new(2005, 04, 28)
-   event.summary = "Meeting with the man."
-   event.klass = "PRIVATE"
-   
-   # Now add it to the calendar
-   cal.add event 
-   
-   # Create a calendar with a single event (Method 2)
-   cal2 = Icalendar::Calendar.new
-   event = cal.event  # This automatically adds the event to the calendar
-   event.user_id = "joe-bob@somewhere.net"
-   event.timestamp = DateTime.now 
-   
-   # Create a calendar with a single event (Method 3)
-   cal3 = Icalendar::Calendar.new
-   cal3.event do
-     user_id "joe-bob@somewhere.net"
-     timestamp DateTime.now 
-   end
+  require 'rubygems' # Unless you install from the tarball or zip.
+  require 'icalendar'
+  require 'date'
+
+  include Icalendar # Probably do this in your class to limit namespace overlap
+
+## Creating calendars and events is easy.
+
+  # Create a calendar with an event (standard method)
+  cal = Calendar.new
+  cal.event do
+    dtstart       Date.new(2005, 04, 29)
+    dtend         Date.new(2005, 04, 28)
+    summary     "Meeting with the man."
+    description "Have a long lunch meeting and decide nothing..."
+    klass       "PRIVATE"
+  end
+
+## Or you can make events like this
+  event = Event.new
+  event.start = DateTime.civil(2006, 6, 23, 8, 30)
+  event.summary = "A great event!"
+  cal.add_event(event)
+
+  event2 = cal.event  # This automatically adds the event to the calendar
+  event2.start = DateTime.civil(2006, 6, 24, 8, 30)
+  event2.summary = "Another great event!"
+
+  # Now with support for property parameters
+  params = {"ALTREP" =>['"http://my.language.net"'], "LANGUAGE" => ["SPANISH"]}
+
+  cal.event do
+    dtstart Date.new(2005, 04, 29)
+    dtend   Date.new(2005, 04, 28)
+    summary "This is a summary with params.", params
+  end
   
-   # We can output the calendars as strings to write to a file, 
-   # network port, database etc.
-   cal_string = cal.to_ical
-   puts cal_string
+  # We can output the calendar as a string to write to a file, 
+  # network port, database etc.
+  cal_string = cal.to_ical
+  puts cal_string
   
 == Parsing iCalendars:
   
-  require 'icalendar'
-  require 'date'
-  
-  # Open a file or string to parse
+  # Open a file or pass a string to the parser
   cal_file = File.open("single_event.ics")
   
   # Parser returns an array of calendars because a single file
-  # can have multiple calendar objects.
-  cals = Icalendar::Parser.new(cal_file).parse
+  # can have multiple calendars.
+  cals = Icalendar.parse(cal_file)
   cal = cals.first
   
   # Now you can access the cal object in just the same way I created it
   event = cal.events.first
   
-  puts "user_id: " + event.user_id
+  puts "start date-time: " + event.dtstart
   puts "summary: " + event.summary
+
+== Finders:
+
+Often times in web apps and other interactive applications you'll need to
+lookup items in a calendar to make changes or get details.  Now you can find
+everything by the unique id automatically associated with all components.
   
-== Including the iCalendar library when using RubyGem:
+  cal = Calendar.new
+  10.times { cal.event } # Create 10 events with only default data.
+  some_event = cal.events[5] # Grab it from the array of events
 
-  begin
-    require 'rubygems'
-    require_gem 'icalendar', ">= 0.96"
-  rescue LoadError
-    require 'icalendar'
-  end
+  # Use the uid as the key in your app
+  key = some_event.uid
+
+  # so later you can find it.
+  same_event = cal.find_event(key)
+
+== Examples:
+
+Check the unit tests for examples of most things you'll want to do, but please
+send me example code or let me know what's missing.
 
 == Download
 
@@ -99,20 +117,15 @@ The latest release version of this library can be found at
 
 * http://rubyforge.org/projects/icalendar/
 
-If you would like to help with development or use the most current version
-you can check out the tree from the subversion repository:
-
-* svn co https://rosejn.net/svn/icalendar icalendar
-
 Documentation can be found at
 
 * http://icalendar.rubyforge.org/
 
 == Installation
 
-This library uses rubygems for distribution and installation:
+It's all about rubygems:
 
-$ gem install icalendar
+$ sudo gem install icalendar
 
 == License
 

data/Rakefile

@@ -2,8 +2,10 @@ require 'rubygems'
 require 'rake'
 require 'rake/testtask'
 require 'rake/rdoctask'
+require 'rake/clean'
+require 'rake/contrib/sshpublisher'
 
-PKG_VERSION = "0.96.4"
+PKG_VERSION = "0.97"
 
 $VERBOSE = nil
 TEST_CHANGES_SINCE = Time.now - 600 # Recent tests = changed in last 10 minutes
@@ -11,28 +13,6 @@ TEST_CHANGES_SINCE = Time.now - 600 # Recent tests = changed in last 10 minutes
 desc "Run all the unit tests"
 task :default => [ :test, :lines ]
 
-# Look up tests for recently modified sources.
-def recent_tests(source_pattern, test_path, touched_since = 10.minutes.ago)
-  FileList[source_pattern].map do |path|
-    if File.mtime(path) > touched_since
-      test = "#{test_path}/#{File.basename(path, '.rb')}_test.rb"
-      test if File.exists?(test)
-    end
-  end.compact
-end
-
-desc 'Test recent changes.'
-Rake::TestTask.new(:rtest) do |t|
-  since = TEST_CHANGES_SINCE
-  touched = FileList['test/**/*_test.rb'].select { |path| File.mtime(path) > since } +
-    recent_tests('lib/icalendar/*.rb', 'test', since) +
-    recent_tests('lib/icalendar/component/*.rb', 'test/component', since)
-
-  t.libs << 'test'
-  t.verbose = true
-  t.test_files = touched.uniq
-end
-
 desc "Run the unit tests in test"
 Rake::TestTask.new(:test) { |t|
   t.libs << "test"
@@ -40,6 +20,30 @@ Rake::TestTask.new(:test) { |t|
   t.verbose = true
 }
 
+# rcov code coverage
+rcov_path = '/usr/local/bin/rcov'
+rcov_test_output = "./test/coverage"
+rcov_exclude = "interactive.rb,read_write.rb,single_event.ics,simplecal,life.ics"
+
+# Add our created paths to the 'rake clobber' list
+CLOBBER.include(rcov_test_output)
+
+desc 'Removes all previous unit test coverage information'
+task (:reset_unit_test_coverage) do |t|
+  rm_rf rcov_unit_test_output
+  mkdir rcov_unit_test_output
+end
+
+desc 'Run all unit tests with Rcov to measure coverage'
+Rake::TestTask.new(:rcov) do |t|
+  t.libs << "test"
+  t.pattern = 'test/**/*_test.rb'
+  t.ruby_opts << rcov_path
+  t.ruby_opts << "-o #{rcov_test_output}"
+  t.ruby_opts << "-x #{rcov_exclude}"
+  t.verbose = true
+end
+
 # Generate the RDoc documentation
 Rake::RDocTask.new(:doc) { |rdoc|
   rdoc.main = 'README'
@@ -47,7 +51,7 @@ Rake::RDocTask.new(:doc) { |rdoc|
   rdoc.rdoc_files.include('GPL', 'COPYING')
   rdoc.rdoc_dir = 'docs/api'
   rdoc.title    = "iCalendar -- Internet Calendaring for Ruby"
-  rdoc.options << "--include examples/ --line-numbers --inline-source"
+  rdoc.options << "--include=examples --line-numbers --inline-source"
   rdoc.options << "--accessor=ical_component,ical_property,ical_multi_property"
 }
 
@@ -80,6 +84,11 @@ Rake::GemPackageTask.new(spec) do |pkg|
   pkg.need_zip = true
 end
 
+desc 'Install the gem globally (requires sudo)'
+task :install => :package do |t|
+  `sudo gem install pkg/icalendar-#{PKG_VERSION}.gem`
+end
+
 task :lines do
   lines = 0
   codelines = 0

data/docs/api/classes/Array.html

@@ -80,6 +80,13 @@
 
   <div id="contextContent">
 
+    <div id="description">
+      <p>
+From the spec: &quot;Values in a list of values MUST be separated by a
+COMMA character (US-ASCII decimal 44).&quot;
+</p>
+
+    </div>
 
 
    </div>
@@ -114,22 +121,13 @@
         <a name="M000002"></a>
 
         <div class="method-heading">
-          <a href="#M000002" class="method-signature">
+          <a href="Array.src/M000002.html" target="Code" class="method-signature"
+            onclick="popupCode('Array.src/M000002.html');return false;">
           <span class="method-name">to_ical</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000002-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000002-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/icalendar/conversions.rb, line 40</span>
-40:   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ical</span>
-41:     <span class="ruby-identifier">map</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">elem</span><span class="ruby-operator">|</span> <span class="ruby-identifier">elem</span>.<span class="ruby-identifier">to_ical</span>}.<span class="ruby-identifier">join</span> <span class="ruby-value str">','</span>
-42:   <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
         </div>
       </div>
 

data/docs/api/classes/Array.src/M000002.html

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>to_ical (Array)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/icalendar/conversions.rb, line 42</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ical</span>
+    <span class="ruby-identifier">map</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">elem</span><span class="ruby-operator">|</span> <span class="ruby-identifier">elem</span>.<span class="ruby-identifier">to_ical</span>}.<span class="ruby-identifier">join</span> <span class="ruby-value str">','</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/docs/api/classes/Date.html

@@ -114,33 +114,13 @@
         <a name="M000004"></a>
 
         <div class="method-heading">
-          <a href="#M000004" class="method-signature">
+          <a href="Date.src/M000004.html" target="Code" class="method-signature"
+            onclick="popupCode('Date.src/M000004.html');return false;">
           <span class="method-name">to_ical</span><span class="method-args">(utc = false)</span>
           </a>
         </div>
       
         <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000004-source">
-<pre>
-     <span class="ruby-comment cmt"># File lib/icalendar/conversions.rb, line 92</span>
- 92:   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ical</span>(<span class="ruby-identifier">utc</span> = <span class="ruby-keyword kw">false</span>)
- 93:     <span class="ruby-identifier">s</span> = <span class="ruby-value str">&quot;&quot;</span>
- 94:         
- 95:     <span class="ruby-comment cmt"># 4 digit year</span>
- 96:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span>.<span class="ruby-identifier">to_s</span>
- 97:     
- 98:     <span class="ruby-comment cmt"># Double digit month</span>
- 99:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
-100:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>.<span class="ruby-identifier">to_s</span>
-101:     
-102:     <span class="ruby-comment cmt"># Double digit day</span>
-103:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
-104:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span>.<span class="ruby-identifier">to_s</span>
-105:   <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
         </div>
       </div>
 

data/docs/api/classes/Date.src/M000004.html

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>to_ical (Date)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/icalendar/conversions.rb, line 94</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ical</span>(<span class="ruby-identifier">utc</span> = <span class="ruby-keyword kw">false</span>)
+    <span class="ruby-identifier">s</span> = <span class="ruby-value str">&quot;&quot;</span>
+        
+    <span class="ruby-comment cmt"># 4 digit year</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span>.<span class="ruby-identifier">to_s</span>
+    
+    <span class="ruby-comment cmt"># Double digit month</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>.<span class="ruby-identifier">to_s</span>
+    
+    <span class="ruby-comment cmt"># Double digit day</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span>.<span class="ruby-identifier">to_s</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/docs/api/classes/DateTime.html

@@ -114,54 +114,13 @@
         <a name="M000005"></a>
 
         <div class="method-heading">
-          <a href="#M000005" class="method-signature">
+          <a href="DateTime.src/M000005.html" target="Code" class="method-signature"
+            onclick="popupCode('DateTime.src/M000005.html');return false;">
           <span class="method-name">to_ical</span><span class="method-args">(utc = false)</span>
           </a>
         </div>
       
         <div class="method-description">
-          <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000005-source">
-<pre>
-    <span class="ruby-comment cmt"># File lib/icalendar/conversions.rb, line 54</span>
-54:   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ical</span>(<span class="ruby-identifier">utc</span> = <span class="ruby-keyword kw">false</span>)
-55:     <span class="ruby-identifier">s</span> = <span class="ruby-value str">&quot;&quot;</span>
-56:     
-57:     <span class="ruby-comment cmt"># 4 digit year</span>
-58:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span>.<span class="ruby-identifier">to_s</span>
-59:     
-60:     <span class="ruby-comment cmt"># Double digit month</span>
-61:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
-62:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>.<span class="ruby-identifier">to_s</span>
-63:     
-64:     <span class="ruby-comment cmt"># Double digit day</span>
-65:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
-66:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span>.<span class="ruby-identifier">to_s</span>
-67: 
-68:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;T&quot;</span>
-69:         
-70:     <span class="ruby-comment cmt"># Double digit hour</span>
-71:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hour</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
-72:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hour</span>.<span class="ruby-identifier">to_s</span>
-73:     
-74:     <span class="ruby-comment cmt"># Double digit minute</span>
-75:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">min</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
-76:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">min</span>.<span class="ruby-identifier">to_s</span>
-77:     
-78:     <span class="ruby-comment cmt"># Double digit second</span>
-79:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sec</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
-80:     <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sec</span>.<span class="ruby-identifier">to_s</span>
-81: 
-82:     <span class="ruby-comment cmt"># UTC time gets a Z suffix</span>
-83:     <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">utc</span>
-84:       <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;Z&quot;</span>
-85:     <span class="ruby-keyword kw">end</span>
-86: 
-87:     <span class="ruby-identifier">s</span>
-88:   <span class="ruby-keyword kw">end</span>
-</pre>
-          </div>
         </div>
       </div>
 

data/docs/api/classes/DateTime.src/M000005.html

@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>to_ical (DateTime)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/icalendar/conversions.rb, line 56</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ical</span>(<span class="ruby-identifier">utc</span> = <span class="ruby-keyword kw">false</span>)
+    <span class="ruby-identifier">s</span> = <span class="ruby-value str">&quot;&quot;</span>
+    
+    <span class="ruby-comment cmt"># 4 digit year</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span>.<span class="ruby-identifier">to_s</span>
+    
+    <span class="ruby-comment cmt"># Double digit month</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>.<span class="ruby-identifier">to_s</span>
+    
+    <span class="ruby-comment cmt"># Double digit day</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span>.<span class="ruby-identifier">to_s</span>
+
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;T&quot;</span>
+        
+    <span class="ruby-comment cmt"># Double digit hour</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hour</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">hour</span>.<span class="ruby-identifier">to_s</span>
+    
+    <span class="ruby-comment cmt"># Double digit minute</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">min</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">min</span>.<span class="ruby-identifier">to_s</span>
+    
+    <span class="ruby-comment cmt"># Double digit second</span>
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;0&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sec</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">9</span> 
+    <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">sec</span>.<span class="ruby-identifier">to_s</span>
+
+    <span class="ruby-comment cmt"># UTC time gets a Z suffix</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">utc</span>
+      <span class="ruby-identifier">s</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value str">&quot;Z&quot;</span>
+    <span class="ruby-keyword kw">end</span>
+
+    <span class="ruby-identifier">s</span>
+  <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>