facets 2.6.0 → 2.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (321) hide show
  1. data/HISTORY.rdoc +331 -35
  2. data/MANIFEST +685 -826
  3. data/{doc/guide/notes.rd → NOTES} +0 -0
  4. data/README.rdoc +73 -25
  5. data/Rakefile +245 -2
  6. data/TODO +5 -0
  7. data/demo/hook.rd +47 -0
  8. data/demo/scenario_require.rd +9 -0
  9. data/doc/README.more +24 -6
  10. data/doc/manual/about.rb +47 -0
  11. data/doc/manual/annotations.rdoc +60 -0
  12. data/doc/manual/associations.rdoc +55 -0
  13. data/doc/manual/blockups.rdoc +101 -0
  14. data/doc/manual/capsule.rdoc +34 -0
  15. data/doc/manual/command.rdoc +177 -0
  16. data/doc/manual/core.rdoc +37 -0
  17. data/doc/manual/faq.rdoc +32 -0
  18. data/doc/manual/typecast.html +112 -0
  19. data/lib/core/facets.rb +359 -11
  20. data/lib/core/facets/array/combination.rb +3 -3
  21. data/lib/core/facets/array/index.rb +4 -1
  22. data/lib/core/facets/array/permutation.rb +2 -2
  23. data/lib/core/facets/array/product.rb +1 -1
  24. data/lib/core/facets/binding/eval.rb +1 -1
  25. data/lib/core/facets/denumerable.rb +76 -0
  26. data/lib/core/facets/duplicable.rb +34 -0
  27. data/lib/core/facets/enumerable/count.rb +10 -4
  28. data/lib/core/facets/enumerable/defer.rb +77 -0
  29. data/lib/core/facets/enumerable/each_by.rb +1 -1
  30. data/lib/core/facets/enumerable/every.rb +35 -0
  31. data/lib/{more/facets/elementwise.rb → core/facets/enumerable/ewise.rb} +0 -0
  32. data/lib/core/facets/enumerable/filter.rb +25 -0
  33. data/lib/core/facets/enumerable/group_by.rb +1 -1
  34. data/lib/core/facets/enumerable/none.rb +3 -2
  35. data/lib/core/facets/enumerable/one.rb +3 -2
  36. data/lib/core/facets/enumerable/per.rb +61 -0
  37. data/lib/core/facets/exception/raised.rb +14 -0
  38. data/lib/core/facets/integer/odd.rb +5 -1
  39. data/lib/core/facets/kernel/__dir__.rb +13 -3
  40. data/lib/core/facets/kernel/__here__.rb +14 -0
  41. data/lib/core/facets/kernel/__method__.rb +9 -3
  42. data/lib/core/facets/kernel/ask.rb +1 -0
  43. data/lib/core/facets/kernel/equate.rb +13 -0
  44. data/lib/core/facets/kernel/extension.rb +9 -0
  45. data/lib/core/facets/kernel/identical.rb +4 -0
  46. data/lib/core/facets/kernel/instance_exec.rb +2 -1
  47. data/lib/core/facets/kernel/method.rb +49 -0
  48. data/lib/core/facets/kernel/object_send.rb +2 -2
  49. data/lib/core/facets/kernel/{state.rb → object_state.rb} +23 -12
  50. data/lib/core/facets/kernel/require_all.rb +6 -1
  51. data/lib/core/facets/kernel/require_local.rb +8 -1
  52. data/lib/core/facets/kernel/require_relative.rb +52 -0
  53. data/lib/core/facets/kernel/source_location.rb +13 -0
  54. data/lib/core/facets/kernel/tap.rb +13 -6
  55. data/lib/core/facets/module/attr_setter.rb +57 -0
  56. data/lib/core/facets/module/instance_method.rb +24 -0
  57. data/lib/core/facets/module/module_load.rb +60 -44
  58. data/lib/core/facets/module/module_require.rb +1 -0
  59. data/lib/core/facets/nilclass/to_f.rb +1 -1
  60. data/lib/core/facets/objectspace/op_fetch.rb +3 -0
  61. data/lib/core/facets/proc/curry.rb +4 -3
  62. data/lib/core/facets/string/bytes.rb +10 -4
  63. data/lib/core/facets/string/camelcase.rb +6 -5
  64. data/lib/core/facets/string/chars.rb +5 -1
  65. data/lib/core/facets/string/each_char.rb +1 -1
  66. data/lib/core/facets/string/each_word.rb +1 -1
  67. data/lib/core/facets/string/lines.rb +11 -4
  68. data/lib/core/facets/string/start_with.rb +9 -2
  69. data/lib/core/facets/string/unfold.rb +27 -0
  70. data/lib/core/facets/symbol/succ.rb +3 -3
  71. data/lib/core/facets/symbol/thrown.rb +20 -0
  72. data/lib/core/facets/symbol/to_proc.rb +3 -2
  73. data/lib/core/facets/time/to_time.rb +1 -1
  74. data/lib/core/facets/to_hash.rb +41 -100
  75. data/lib/core/facets/unboundmethod/name.rb +20 -23
  76. data/lib/more/facets/ansicode.rb +1 -10
  77. data/lib/more/facets/autoarray.rb +3 -31
  78. data/lib/more/facets/basicobject.rb +73 -0
  79. data/lib/more/facets/blankslate.rb +2 -66
  80. data/lib/{lore → more}/facets/cgi.rb +0 -0
  81. data/lib/more/facets/class_extend.rb +1 -0
  82. data/lib/{lore → more}/facets/continuation.rb +0 -0
  83. data/lib/{lore → more}/facets/date.rb +3 -3
  84. data/lib/more/facets/enumargs.rb +192 -0
  85. data/lib/more/facets/enumerablepass.rb +2 -216
  86. data/lib/more/facets/enumerator.rb +62 -0
  87. data/lib/more/facets/{equatable.rb → equitable.rb} +11 -11
  88. data/lib/more/facets/expirable.rb +13 -41
  89. data/lib/{lore → more}/facets/fileutils.rb +0 -0
  90. data/lib/{lore → more}/facets/fileutils/head.rb +0 -0
  91. data/lib/{lore → more}/facets/fileutils/safe_ln.rb +0 -0
  92. data/lib/{lore → more}/facets/fileutils/slice.rb +0 -0
  93. data/lib/{lore → more}/facets/fileutils/tail.rb +0 -0
  94. data/lib/{lore → more}/facets/fileutils/wc.rb +0 -0
  95. data/lib/{lore → more}/facets/fileutils/whereis.rb +0 -0
  96. data/lib/{lore → more}/facets/fileutils/which.rb +0 -0
  97. data/lib/{lore → more}/facets/getoptlong.rb +0 -0
  98. data/lib/more/facets/hook.rb +2 -29
  99. data/lib/more/facets/inheritor.rb +2 -2
  100. data/lib/more/facets/instance_eval.rb +50 -0
  101. data/lib/more/facets/instance_function.rb +78 -0
  102. data/lib/more/facets/main.rb +20 -15
  103. data/lib/more/facets/memoize.rb +1 -113
  104. data/lib/more/facets/module/attr.rb +83 -0
  105. data/lib/more/facets/module/attr_tester.rb +44 -0
  106. data/lib/more/facets/module/attr_toggler.rb +59 -0
  107. data/lib/more/facets/module/attr_validator.rb +34 -0
  108. data/lib/more/facets/{class_extension.rb → module/class_extend.rb} +21 -13
  109. data/lib/more/facets/once.rb +59 -0
  110. data/lib/more/facets/openmodule.rb +1 -0
  111. data/lib/more/facets/orderedhash.rb +1 -33
  112. data/lib/{lore → more}/facets/ostruct.rb +0 -0
  113. data/lib/more/facets/ostructable.rb +1 -4
  114. data/lib/more/facets/partial.rb +18 -16
  115. data/lib/{lore → more}/facets/pathname.rb +0 -0
  116. data/lib/more/facets/preinitialize.rb +157 -0
  117. data/lib/{lore → more}/facets/rbconfig.rb +0 -0
  118. data/lib/more/facets/recorder.rb +1 -2
  119. data/lib/{lore → more}/facets/set.rb +0 -0
  120. data/lib/{lore → more}/facets/shellwords.rb +0 -0
  121. data/lib/{lore → more}/facets/uri.rb +0 -0
  122. data/lib/{lore → more}/facets/yaml.rb +0 -0
  123. data/lib/{lore → more}/facets/zlib.rb +0 -0
  124. data/meta/loadpath +0 -1
  125. data/meta/sitemap +4 -0
  126. data/meta/version +1 -1
  127. data/test/core/enumerable/test_count.rb +1 -1
  128. data/test/{more/test_filter.rb → core/enumerable/test_defer.rb} +24 -22
  129. data/test/{more/test_elementor.rb → core/enumerable/test_every.rb} +2 -15
  130. data/test/core/enumerable/test_ewise.rb +23 -0
  131. data/test/core/enumerable/test_per.rb +18 -0
  132. data/test/core/enumerable/test_take.rb +13 -0
  133. data/test/core/kernel/test_deepcopy.rb +1 -1
  134. data/test/{more/test_1stclassmethod.rb → core/kernel/test_method.rb} +2 -7
  135. data/test/core/kernel/test_tap.rb +1 -1
  136. data/test/core/proc/test_curry.rb +11 -0
  137. data/test/core/string/test_bytes.rb +1 -1
  138. data/test/core/string/test_camelcase.rb +23 -6
  139. data/test/core/string/test_lines.rb +1 -1
  140. data/test/core/string/test_unfold.rb +14 -0
  141. data/test/{more → core}/test_blank.rb +0 -0
  142. data/test/{more → core}/test_boolean.rb +0 -0
  143. data/test/{more → core}/test_functor.rb +0 -0
  144. data/test/{lore → more}/test_basicobject.rb +0 -0
  145. data/test/more/{test_class_extension.rb → test_class_extend.rb} +6 -6
  146. data/test/{lore → more}/test_continuation.rb +0 -0
  147. data/test/{lore → more}/test_date.rb +0 -0
  148. data/test/more/{test_enumerablepass.rb → test_enumargs.rb} +2 -4
  149. data/test/more/{test_equatable.rb → test_equitable.rb} +2 -2
  150. data/test/more/{test_instantise.rb → test_instance_function.rb} +3 -2
  151. data/test/more/test_memoize.rb +1 -1
  152. data/test/{lore → more}/test_ostruct.rb +0 -0
  153. metadata +865 -1016
  154. data/RELEASE +0 -38
  155. data/doc/README.lore +0 -51
  156. data/doc/log/basic_stats/index.html +0 -39
  157. data/doc/log/changelog.html +0 -648
  158. data/doc/log/changelog.txt +0 -217
  159. data/doc/log/stats/index.html +0 -39
  160. data/doc/log/testlog.txt +0 -278
  161. data/doc/notes/CHANGES +0 -2529
  162. data/doc/rdoc/lore/classes/Array.html +0 -176
  163. data/doc/rdoc/lore/classes/CGI.html +0 -191
  164. data/doc/rdoc/lore/classes/Config.html +0 -135
  165. data/doc/rdoc/lore/classes/Continuation.html +0 -113
  166. data/doc/rdoc/lore/classes/Date.html +0 -631
  167. data/doc/rdoc/lore/classes/DateTime.html +0 -583
  168. data/doc/rdoc/lore/classes/Enumerable.html +0 -89
  169. data/doc/rdoc/lore/classes/Enumerable/Enumerator.html +0 -147
  170. data/doc/rdoc/lore/classes/File.html +0 -128
  171. data/doc/rdoc/lore/classes/FileUtils.html +0 -434
  172. data/doc/rdoc/lore/classes/GetoptLong.html +0 -118
  173. data/doc/rdoc/lore/classes/GetoptLong/DSL.html +0 -208
  174. data/doc/rdoc/lore/classes/Kernel.html +0 -135
  175. data/doc/rdoc/lore/classes/Logger.html +0 -229
  176. data/doc/rdoc/lore/classes/Logger/Ansicolor.html +0 -277
  177. data/doc/rdoc/lore/classes/Logger/LogDevice.html +0 -121
  178. data/doc/rdoc/lore/classes/NilClass.html +0 -119
  179. data/doc/rdoc/lore/classes/OpenStruct.html +0 -432
  180. data/doc/rdoc/lore/classes/Pathname.html +0 -353
  181. data/doc/rdoc/lore/classes/Set.html +0 -117
  182. data/doc/rdoc/lore/classes/Shellwords.html +0 -111
  183. data/doc/rdoc/lore/classes/String.html +0 -140
  184. data/doc/rdoc/lore/classes/Time.html +0 -154
  185. data/doc/rdoc/lore/classes/URI.html +0 -454
  186. data/doc/rdoc/lore/classes/URI/Hash.html +0 -105
  187. data/doc/rdoc/lore/classes/URI/Kernel.html +0 -122
  188. data/doc/rdoc/lore/classes/Zlib.html +0 -188
  189. data/doc/rdoc/lore/created.rid +0 -1
  190. data/doc/rdoc/lore/files/README.html +0 -286
  191. data/doc/rdoc/lore/files/doc/README_lore.html +0 -155
  192. data/doc/rdoc/lore/files/lib/lore/facets/basicobject_rb.html +0 -118
  193. data/doc/rdoc/lore/files/lib/lore/facets/cgi_rb.html +0 -111
  194. data/doc/rdoc/lore/files/lib/lore/facets/continuation_rb.html +0 -147
  195. data/doc/rdoc/lore/files/lib/lore/facets/date_rb.html +0 -97
  196. data/doc/rdoc/lore/files/lib/lore/facets/enumerator_rb.html +0 -111
  197. data/doc/rdoc/lore/files/lib/lore/facets/fileutils/head_rb.html +0 -96
  198. data/doc/rdoc/lore/files/lib/lore/facets/fileutils/safe_ln_rb.html +0 -96
  199. data/doc/rdoc/lore/files/lib/lore/facets/fileutils/slice_rb.html +0 -96
  200. data/doc/rdoc/lore/files/lib/lore/facets/fileutils/tail_rb.html +0 -96
  201. data/doc/rdoc/lore/files/lib/lore/facets/fileutils/wc_rb.html +0 -96
  202. data/doc/rdoc/lore/files/lib/lore/facets/fileutils/whereis_rb.html +0 -96
  203. data/doc/rdoc/lore/files/lib/lore/facets/fileutils/which_rb.html +0 -96
  204. data/doc/rdoc/lore/files/lib/lore/facets/fileutils_rb.html +0 -131
  205. data/doc/rdoc/lore/files/lib/lore/facets/getoptlong_rb.html +0 -135
  206. data/doc/rdoc/lore/files/lib/lore/facets/logger_rb.html +0 -142
  207. data/doc/rdoc/lore/files/lib/lore/facets/ostruct_rb.html +0 -135
  208. data/doc/rdoc/lore/files/lib/lore/facets/pathname_rb.html +0 -145
  209. data/doc/rdoc/lore/files/lib/lore/facets/rbconfig_rb.html +0 -124
  210. data/doc/rdoc/lore/files/lib/lore/facets/set_rb.html +0 -96
  211. data/doc/rdoc/lore/files/lib/lore/facets/shellwords_rb.html +0 -124
  212. data/doc/rdoc/lore/files/lib/lore/facets/uri_rb.html +0 -125
  213. data/doc/rdoc/lore/files/lib/lore/facets/yaml_rb.html +0 -146
  214. data/doc/rdoc/lore/files/lib/lore/facets/zlib_rb.html +0 -97
  215. data/doc/rdoc/lore/fr_class_index.html +0 -73
  216. data/doc/rdoc/lore/fr_file_index.html +0 -71
  217. data/doc/rdoc/lore/fr_method_index.html +0 -177
  218. data/doc/rdoc/lore/index.html +0 -26
  219. data/doc/rdoc/lore/rdoc-style.css +0 -177
  220. data/doc/release-notes/RELEASE-2.0.5 +0 -8
  221. data/doc/release-notes/RELEASE-2.1.0 +0 -9
  222. data/doc/release-notes/RELEASE-2.1.1 +0 -5
  223. data/doc/release-notes/RELEASE-2.1.2 +0 -6
  224. data/doc/release-notes/RELEASE-2.1.3 +0 -5
  225. data/doc/release-notes/RELEASE-2.2.0 +0 -14
  226. data/doc/release-notes/RELEASE-2.2.1 +0 -4
  227. data/doc/release-notes/RELEASE-2.3.0 +0 -6
  228. data/doc/release-notes/RELEASE-2.4.0 +0 -70
  229. data/doc/release-notes/RELEASE-2.4.1 +0 -8
  230. data/doc/release-notes/RELEASE-2.4.2 +0 -4
  231. data/doc/release-notes/RELEASE-2.4.3 +0 -78
  232. data/doc/release-notes/RELEASE-2.4.4 +0 -38
  233. data/doc/release-notes/RELEASE-2.4.5 +0 -37
  234. data/doc/release-notes/RELEASE-2.5.0 +0 -83
  235. data/lib/core/facets/kernel/instance.rb +0 -19
  236. data/lib/lore/facets/basicobject.rb +0 -14
  237. data/lib/lore/facets/enumerator.rb +0 -67
  238. data/lib/lore/facets/logger.rb +0 -291
  239. data/lib/more/facets/1stclassmethod.rb +0 -140
  240. data/lib/more/facets/advisable.rb +0 -162
  241. data/lib/more/facets/association.rb +0 -210
  242. data/lib/more/facets/attr.rb +0 -209
  243. data/lib/more/facets/basex.rb +0 -37
  244. data/lib/more/facets/bbcode.rb +0 -397
  245. data/lib/more/facets/bicrypt.rb +0 -265
  246. data/lib/more/facets/binreadable.rb +0 -221
  247. data/lib/more/facets/censor.rb +0 -97
  248. data/lib/more/facets/classmethods.rb +0 -199
  249. data/lib/more/facets/consoleutils.rb +0 -99
  250. data/lib/more/facets/crypt.rb +0 -166
  251. data/lib/more/facets/dependency.rb +0 -151
  252. data/lib/more/facets/downloader.rb +0 -281
  253. data/lib/more/facets/duplicable.rb +0 -43
  254. data/lib/more/facets/elementor.rb +0 -133
  255. data/lib/more/facets/filter.rb +0 -121
  256. data/lib/more/facets/heap.rb +0 -22
  257. data/lib/more/facets/infinity.rb +0 -193
  258. data/lib/more/facets/ini.rb +0 -264
  259. data/lib/more/facets/instantise.rb +0 -1
  260. data/lib/more/facets/instantize.rb +0 -95
  261. data/lib/more/facets/interval.rb +0 -282
  262. data/lib/more/facets/iteration.rb +0 -65
  263. data/lib/more/facets/linkedlist.rb +0 -222
  264. data/lib/more/facets/lrucache.rb +0 -157
  265. data/lib/more/facets/matcher.rb +0 -140
  266. data/lib/more/facets/memoizer.rb +0 -74
  267. data/lib/more/facets/minitar.rb +0 -1063
  268. data/lib/more/facets/nackclass.rb +0 -41
  269. data/lib/more/facets/net/smtp_tls.rb +0 -131
  270. data/lib/more/facets/nilstatus.rb +0 -48
  271. data/lib/more/facets/overload.rb +0 -94
  272. data/lib/more/facets/paramix.rb +0 -202
  273. data/lib/more/facets/pool.rb +0 -91
  274. data/lib/more/facets/pqueue.rb +0 -449
  275. data/lib/more/facets/pry.rb +0 -32
  276. data/lib/more/facets/reflection.rb +0 -145
  277. data/lib/more/facets/semaphore.rb +0 -92
  278. data/lib/more/facets/settings.rb +0 -248
  279. data/lib/more/facets/snapshot.rb +0 -209
  280. data/lib/more/facets/sparse_array.rb +0 -809
  281. data/lib/more/facets/string/mask.rb +0 -278
  282. data/lib/more/facets/string/obfuscate.rb +0 -65
  283. data/lib/more/facets/string/stylize.rb +0 -169
  284. data/lib/more/facets/string/words.rb +0 -167
  285. data/lib/more/facets/syncarray.rb +0 -114
  286. data/lib/more/facets/synchash.rb +0 -157
  287. data/lib/more/facets/typecast.rb +0 -261
  288. data/lib/more/facets/uninheritable.rb +0 -50
  289. data/lib/more/facets/xmlhash.rb +0 -112
  290. data/lib/more/facets/xoxo.rb +0 -259
  291. data/lib/more/facets/ziputils.rb +0 -490
  292. data/task/conflicts +0 -63
  293. data/task/coverage.rake +0 -37
  294. data/task/methods +0 -49
  295. data/task/rdoc.rake +0 -17
  296. data/task/setup.rake +0 -38
  297. data/task/test.rake +0 -145
  298. data/test/more/test_advisable.rb +0 -71
  299. data/test/more/test_association.rb +0 -38
  300. data/test/more/test_bbcode.rb +0 -21
  301. data/test/more/test_binreadable.rb +0 -50
  302. data/test/more/test_buildable.rb +0 -73
  303. data/test/more/test_classmethods.rb +0 -56
  304. data/test/more/test_crypt.rb +0 -32
  305. data/test/more/test_dependency.rb +0 -69
  306. data/test/more/test_elementwise.rb +0 -25
  307. data/test/more/test_infinity.rb +0 -40
  308. data/test/more/test_interval.rb +0 -151
  309. data/test/more/test_linkedlist.rb +0 -41
  310. data/test/more/test_lrucache.rb +0 -14
  311. data/test/more/test_overload.rb +0 -160
  312. data/test/more/test_paramix.rb +0 -170
  313. data/test/more/test_prototype.rb +0 -35
  314. data/test/more/test_snapshot.rb +0 -21
  315. data/test/more/test_sparsearray.rb +0 -279
  316. data/test/more/test_syncarray.rb +0 -15
  317. data/test/more/test_synchash.rb +0 -16
  318. data/test/more/test_typecast.rb +0 -54
  319. data/test/more/test_uninheritable.rb +0 -31
  320. data/test/more/test_xoxo.rb +0 -274
  321. data/test/test_facets.rb +0 -9
data/doc/rdoc/lore/classes/Continuation.html DELETED
@@ -1,113 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
- <html>
6
- <head>
7
- <title>Class: Continuation</title>
8
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
9
- <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
10
-
11
- <script language="JavaScript" type="text/javascript">
12
- // <![CDATA[
13
-
14
- function toggleSource( id )
15
- {
16
- var elem
17
- var link
18
-
19
- if( document.getElementById )
20
- {
21
- elem = document.getElementById( id )
22
- link = document.getElementById( "l_" + id )
23
- }
24
- else if ( document.all )
25
- {
26
- elem = eval( "document.all." + id )
27
- link = eval( "document.all.l_" + id )
28
- }
29
- else
30
- return false;
31
-
32
- if( elem.style.display == "block" )
33
- {
34
- elem.style.display = "none"
35
- link.innerHTML = "+"
36
- }
37
- else
38
- {
39
- elem.style.display = "block"
40
- link.innerHTML = "-"
41
- }
42
- }
43
-
44
- function openCode( url )
45
- {
46
- window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
47
- }
48
- // ]]>
49
- </script>
50
- </head>
51
-
52
- <body>
53
- <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
54
- <td class="file-title"><span class="file-title-prefix">Class</span><br />Continuation</td>
55
- <td align="right">
56
- <table cellspacing="0" cellpadding="2">
57
- <tr valign="top">
58
- <td>In:</td>
59
- <td>
60
- </td>
61
- </tr>
62
- <tr>
63
- <td>Parent:</td>
64
- <td>
65
- Object
66
- </td>
67
- </tr>
68
- </table>
69
- </td>
70
- </tr>
71
- </table>
72
- <!-- banner header -->
73
-
74
- <div id="bodyContent">
75
- <div id="content">
76
-
77
-
78
-
79
-
80
- <div class="sectiontitle">Methods</div>
81
- <span style="padding-right: 5px;"><a href="#M000008">create</a></span>
82
-
83
-
84
-
85
-
86
-
87
-
88
- <div class="sectiontitle">Public Class methods</div>
89
- <div class="method">
90
- <div class="title">
91
- <a name="M000008"></a><b>create</b>(*args, &amp;block)
92
- </div>
93
- <div class="sourcecode">
94
- <p class="source-link">[ <a href="javascript:toggleSource('M000008_source')" id="l_M000008_source">+</a> ]</p>
95
- <div id="M000008_source" class="dyn-source">
96
- <pre>
97
- <span class="ruby-comment cmt"># File lib/lore/facets/continuation.rb, line 52</span>
98
- <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Continuation</span>.<span class="ruby-identifier">create</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
99
- <span class="ruby-identifier">args</span> = [<span class="ruby-identifier">args</span>] <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-keyword kw">and</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">is_a?</span> <span class="ruby-constant">Array</span> <span class="ruby-comment cmt"># 1.6.8 compatibility</span>
100
- <span class="ruby-identifier">cc</span> = <span class="ruby-keyword kw">nil</span>; <span class="ruby-identifier">result</span> = <span class="ruby-identifier">callcc</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span> <span class="ruby-identifier">cc</span> = <span class="ruby-identifier">c</span>; <span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">cc</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">args</span>.<span class="ruby-identifier">empty?</span>}
101
- <span class="ruby-identifier">result</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">args</span>
102
- <span class="ruby-keyword kw">return</span> <span class="ruby-operator">*</span>[<span class="ruby-identifier">cc</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">result</span>]
103
- <span class="ruby-keyword kw">end</span>
104
- </pre>
105
- </div>
106
- </div>
107
- </div>
108
- </div>
109
-
110
- </div>
111
-
112
- </body>
113
- </html>
data/doc/rdoc/lore/classes/Date.html DELETED
@@ -1,631 +0,0 @@
1
- <?xml version="1.0" encoding="iso-8859-1"?>
2
- <!DOCTYPE html
3
- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
- <html>
6
- <head>
7
- <title>Class: Date</title>
8
- <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
9
- <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
10
-
11
- <script language="JavaScript" type="text/javascript">
12
- // <![CDATA[
13
-
14
- function toggleSource( id )
15
- {
16
- var elem
17
- var link
18
-
19
- if( document.getElementById )
20
- {
21
- elem = document.getElementById( id )
22
- link = document.getElementById( "l_" + id )
23
- }
24
- else if ( document.all )
25
- {
26
- elem = eval( "document.all." + id )
27
- link = eval( "document.all.l_" + id )
28
- }
29
- else
30
- return false;
31
-
32
- if( elem.style.display == "block" )
33
- {
34
- elem.style.display = "none"
35
- link.innerHTML = "+"
36
- }
37
- else
38
- {
39
- elem.style.display = "block"
40
- link.innerHTML = "-"
41
- }
42
- }
43
-
44
- function openCode( url )
45
- {
46
- window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
47
- }
48
- // ]]>
49
- </script>
50
- </head>
51
-
52
- <body>
53
- <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
54
- <td class="file-title"><span class="file-title-prefix">Class</span><br />Date</td>
55
- <td align="right">
56
- <table cellspacing="0" cellpadding="2">
57
- <tr valign="top">
58
- <td>In:</td>
59
- <td>
60
- <a href="../files/lib/lore/facets/date_rb.html">lib/lore/facets/date.rb</a>
61
- </td>
62
- </tr>
63
- <tr>
64
- <td>Parent:</td>
65
- <td>
66
- Object
67
- </td>
68
- </tr>
69
- </table>
70
- </td>
71
- </tr>
72
- </table>
73
- <!-- banner header -->
74
-
75
- <div id="bodyContent">
76
- <div id="content">
77
-
78
- <div class="description"><h1><a href="Date.html">Date</a></h1>
79
- <p>
80
- This new version of <a href="Date.html">Date</a> extension has been largely
81
- improved by porting some of the methods used by ActiveSupport. The old
82
- version already had much <a href="Date.html#M000035">in</a> common with the
83
- Active Support library, so it was decided to take it a step further <a
84
- href="Date.html#M000035">in</a> that direction for the sake of
85
- interoparability.
86
- </p>
87
- <p>
88
- Hopefully most of these methods will find there way into Ruby&#8216;s own
89
- standard library eventually.
90
- </p>
91
- <p>
92
- The biggest difference with ActiveSupport is the lack of many of the
93
- &quot;English-esque&quot; methods, and that we use <a
94
- href="Date.html#M000030">stamp</a> with Date::FORMAT, instead of
95
- to_formmated_s with Date::DATE_FORMATS. We do not override the standard
96
- to_s method like ActiveSupport does.
97
- </p>
98
- </div>
99
-
100
-
101
-
102
- <div class="sectiontitle">Methods</div>
103
- <span style="padding-right: 5px;"><a href="#M000031">advance</a></span>
104
- <span style="padding-right: 5px;"><a href="#M000033">ago</a></span>
105
- <span style="padding-right: 5px;"><a href="#M000036">beginning_of_day</a></span>
106
- <span style="padding-right: 5px;"><a href="#M000032">change</a></span>
107
- <span style="padding-right: 5px;"><a href="#M000022">current</a></span>
108
- <span style="padding-right: 5px;"><a href="#M000027">days_in_month</a></span>
109
- <span style="padding-right: 5px;"><a href="#M000028">days_of_month</a></span>
110
- <span style="padding-right: 5px;"><a href="#M000035">in</a></span>
111
- <span style="padding-right: 5px;"><a href="#M000037">midnight</a></span>
112
- <span style="padding-right: 5px;"><a href="#M000029">month_name</a></span>
113
- <span style="padding-right: 5px;"><a href="#M000034">since</a></span>
114
- <span style="padding-right: 5px;"><a href="#M000030">stamp</a></span>
115
- <span style="padding-right: 5px;"><a href="#M000023">to_date</a></span>
116
- <span style="padding-right: 5px;"><a href="#M000024">to_datetime</a></span>
117
- <span style="padding-right: 5px;"><a href="#M000025">to_time</a></span>
118
- <span style="padding-right: 5px;"><a href="#M000021">tomorrow</a></span>
119
- <span style="padding-right: 5px;"><a href="#M000039">tomorrow</a></span>
120
- <span style="padding-right: 5px;"><a href="#M000026">xmlschema</a></span>
121
- <span style="padding-right: 5px;"><a href="#M000038">yesterday</a></span>
122
- <span style="padding-right: 5px;"><a href="#M000020">yesterday</a></span>
123
-
124
-
125
-
126
-
127
- <div class="sectiontitle">Constants</div>
128
- <table border='0' cellpadding='5'>
129
- <tr valign='top'>
130
- <td class="attr-name">FORMAT</td>
131
- <td>=</td>
132
- <td class="attr-value">{ :short =&gt; &quot;%e %b&quot;, :long =&gt; &quot;%B %e, %Y&quot;, :db =&gt; &quot;%Y-%m-%d&quot;, :number =&gt; &quot;%Y%m%d&quot;, :rfc822 =&gt; &quot;%e %b %Y&quot;, :default =&gt; &quot;%Y-%m-%d&quot;, nil =&gt; &quot;%Y-%m-%d&quot;</td>
133
- </tr>
134
- </table>
135
-
136
-
137
- <div class="sectiontitle">Public Class methods</div>
138
- <div class="method">
139
- <div class="title">
140
- <a name="M000022"></a><b>current</b>()
141
- </div>
142
- <div class="description">
143
- <p>
144
- Returns Time.zone.today when config.time_zone is set, otherwise just
145
- returns Date.today.
146
- </p>
147
- </div>
148
- <div class="sourcecode">
149
- <p class="source-link">[ <a href="javascript:toggleSource('M000022_source')" id="l_M000022_source">+</a> ]</p>
150
- <div id="M000022_source" class="dyn-source">
151
- <pre>
152
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 43</span>
153
- <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">current</span>
154
- <span class="ruby-operator">::</span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">zone_default</span> <span class="ruby-value">? </span><span class="ruby-operator">::</span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">zone</span>.<span class="ruby-identifier">today</span> <span class="ruby-operator">:</span> <span class="ruby-operator">::</span><span class="ruby-constant">Date</span>.<span class="ruby-identifier">today</span>
155
- <span class="ruby-keyword kw">end</span>
156
- </pre>
157
- </div>
158
- </div>
159
- </div>
160
- <div class="method">
161
- <div class="title">
162
- <a name="M000021"></a><b>tomorrow</b>()
163
- </div>
164
- <div class="description">
165
- <p>
166
- Returns a new <a href="Date.html">Date</a> representing the date 1 day
167
- after today (i.e. <a href="Date.html#M000021">tomorrow</a>&#8216;s date).
168
- </p>
169
- </div>
170
- <div class="sourcecode">
171
- <p class="source-link">[ <a href="javascript:toggleSource('M000021_source')" id="l_M000021_source">+</a> ]</p>
172
- <div id="M000021_source" class="dyn-source">
173
- <pre>
174
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 38</span>
175
- <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">tomorrow</span>
176
- <span class="ruby-operator">::</span><span class="ruby-constant">Date</span>.<span class="ruby-identifier">today</span>.<span class="ruby-identifier">tomorrow</span>
177
- <span class="ruby-keyword kw">end</span>
178
- </pre>
179
- </div>
180
- </div>
181
- </div>
182
- <div class="method">
183
- <div class="title">
184
- <a name="M000020"></a><b>yesterday</b>()
185
- </div>
186
- <div class="description">
187
- <p>
188
- Returns a new <a href="Date.html">Date</a> representing the date 1 day <a
189
- href="Date.html#M000033">ago</a> (i.e. <a
190
- href="Date.html#M000020">yesterday</a>&#8216;s date).
191
- </p>
192
- </div>
193
- <div class="sourcecode">
194
- <p class="source-link">[ <a href="javascript:toggleSource('M000020_source')" id="l_M000020_source">+</a> ]</p>
195
- <div id="M000020_source" class="dyn-source">
196
- <pre>
197
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 33</span>
198
- <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">yesterday</span>
199
- <span class="ruby-operator">::</span><span class="ruby-constant">Date</span>.<span class="ruby-identifier">today</span>.<span class="ruby-identifier">yesterday</span>
200
- <span class="ruby-keyword kw">end</span>
201
- </pre>
202
- </div>
203
- </div>
204
- </div>
205
- <div class="sectiontitle">Public Instance methods</div>
206
- <div class="method">
207
- <div class="title">
208
- <a name="M000031"></a><b>advance</b>(options)
209
- </div>
210
- <div class="description">
211
- <p>
212
- Provides precise <a href="Date.html">Date</a> calculations for years,
213
- months, and days. The <tt>options</tt> parameter takes a hash with any of
214
- these keys: <tt>:years</tt>, <tt>:months</tt>, <tt>:weeks</tt>,
215
- <tt>:days</tt>.
216
- </p>
217
- </div>
218
- <div class="sourcecode">
219
- <p class="source-link">[ <a href="javascript:toggleSource('M000031_source')" id="l_M000031_source">+</a> ]</p>
220
- <div id="M000031_source" class="dyn-source">
221
- <pre>
222
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 139</span>
223
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">advance</span>(<span class="ruby-identifier">options</span>)
224
- <span class="ruby-identifier">d</span> = <span class="ruby-keyword kw">self</span>
225
- <span class="ruby-identifier">d</span> = <span class="ruby-identifier">d</span> <span class="ruby-operator">&gt;&gt;</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:years</span>) <span class="ruby-operator">*</span> <span class="ruby-value">12</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:years</span>]
226
- <span class="ruby-identifier">d</span> = <span class="ruby-identifier">d</span> <span class="ruby-operator">&gt;&gt;</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:months</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:months</span>]
227
- <span class="ruby-identifier">d</span> = <span class="ruby-identifier">d</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:weeks</span>) <span class="ruby-operator">*</span> <span class="ruby-value">7</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:weeks</span>]
228
- <span class="ruby-identifier">d</span> = <span class="ruby-identifier">d</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">:days</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:days</span>]
229
- <span class="ruby-identifier">d</span>
230
- <span class="ruby-keyword kw">end</span>
231
- </pre>
232
- </div>
233
- </div>
234
- </div>
235
- <div class="method">
236
- <div class="title">
237
- <a name="M000033"></a><b>ago</b>(seconds)
238
- </div>
239
- <div class="description">
240
- <p>
241
- Converts <a href="Date.html">Date</a> to a <a href="Time.html">Time</a> (or
242
- <a href="DateTime.html">DateTime</a> if necessary) with the time portion
243
- set to the beginning of the day (0:00) and then subtracts the specified
244
- number of seconds
245
- </p>
246
- </div>
247
- <div class="sourcecode">
248
- <p class="source-link">[ <a href="javascript:toggleSource('M000033_source')" id="l_M000033_source">+</a> ]</p>
249
- <div id="M000033_source" class="dyn-source">
250
- <pre>
251
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 164</span>
252
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ago</span>(<span class="ruby-identifier">seconds</span>)
253
- <span class="ruby-identifier">to_time</span>.<span class="ruby-identifier">since</span>(<span class="ruby-operator">-</span><span class="ruby-identifier">seconds</span>)
254
- <span class="ruby-keyword kw">end</span>
255
- </pre>
256
- </div>
257
- </div>
258
- </div>
259
- <div class="method">
260
- <div class="title">
261
- <a name="M000036"></a><b>beginning_of_day</b>()
262
- </div>
263
- <div class="description">
264
- <p>
265
- Converts <a href="Date.html">Date</a> to a <a href="Time.html">Time</a> (or
266
- <a href="DateTime.html">DateTime</a> if necessary) with the time portion
267
- set to the beginning of the day (0:00)
268
- </p>
269
- </div>
270
- <div class="aka">
271
- This method is also aliased as
272
- <a href="Date.html#M000037">midnight</a>
273
- </div>
274
- <div class="sourcecode">
275
- <p class="source-link">[ <a href="javascript:toggleSource('M000036_source')" id="l_M000036_source">+</a> ]</p>
276
- <div id="M000036_source" class="dyn-source">
277
- <pre>
278
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 176</span>
279
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">beginning_of_day</span>
280
- <span class="ruby-identifier">to_time</span>
281
- <span class="ruby-keyword kw">end</span>
282
- </pre>
283
- </div>
284
- </div>
285
- </div>
286
- <div class="method">
287
- <div class="title">
288
- <a name="M000032"></a><b>change</b>(options)
289
- </div>
290
- <div class="description">
291
- <p>
292
- Returns a new <a href="Date.html">Date</a> where one or more of the
293
- elements have been changed according to the <tt>options</tt> parameter.
294
- </p>
295
- <p>
296
- Examples:
297
- </p>
298
- <pre>
299
- Date.new(2007, 5, 12).change(:day =&gt; 1) # =&gt; Date.new(2007, 5, 1)
300
- Date.new(2007, 5, 12).change(:year =&gt; 2005, :month =&gt; 1) # =&gt; Date.new(2005, 1, 12)
301
- </pre>
302
- </div>
303
- <div class="sourcecode">
304
- <p class="source-link">[ <a href="javascript:toggleSource('M000032_source')" id="l_M000032_source">+</a> ]</p>
305
- <div id="M000032_source" class="dyn-source">
306
- <pre>
307
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 154</span>
308
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">change</span>(<span class="ruby-identifier">options</span>)
309
- <span class="ruby-operator">::</span><span class="ruby-constant">Date</span>.<span class="ruby-identifier">new</span>(
310
- <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:year</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">year</span>,
311
- <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:month</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>,
312
- <span class="ruby-identifier">options</span>[<span class="ruby-identifier">:day</span>] <span class="ruby-operator">||</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">day</span>
313
- )
314
- <span class="ruby-keyword kw">end</span>
315
- </pre>
316
- </div>
317
- </div>
318
- </div>
319
- <div class="method">
320
- <div class="title">
321
- <a name="M000027"></a><b>days_in_month</b>()
322
- </div>
323
- <div class="description">
324
- <p>
325
- Returns the number of days <a href="Date.html#M000035">in</a> the
326
- date&#8216;s month.
327
- </p>
328
- <pre>
329
- Date.new(2004,2).days_in_month #=&gt; 28
330
- </pre>
331
- <p>
332
- CREDIT: Ken Kunz.
333
- </p>
334
- </div>
335
- <div class="sourcecode">
336
- <p class="source-link">[ <a href="javascript:toggleSource('M000027_source')" id="l_M000027_source">+</a> ]</p>
337
- <div id="M000027_source" class="dyn-source">
338
- <pre>
339
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 89</span>
340
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">days_in_month</span>
341
- <span class="ruby-constant">Date</span>.<span class="ruby-identifier">civil</span>(<span class="ruby-identifier">year</span>, <span class="ruby-identifier">month</span>, <span class="ruby-value">-1</span>).<span class="ruby-identifier">day</span>
342
- <span class="ruby-keyword kw">end</span>
343
- </pre>
344
- </div>
345
- </div>
346
- </div>
347
- <div class="method">
348
- <div class="title">
349
- <a name="M000028"></a><b>days_of_month</b>()
350
- </div>
351
- <div class="sourcecode">
352
- <p class="source-link">[ <a href="javascript:toggleSource('M000028_source')" id="l_M000028_source">+</a> ]</p>
353
- <div id="M000028_source" class="dyn-source">
354
- <pre>
355
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 93</span>
356
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">days_of_month</span>
357
- (<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-identifier">days_in_month</span>).<span class="ruby-identifier">to_a</span>
358
- <span class="ruby-keyword kw">end</span>
359
- </pre>
360
- </div>
361
- </div>
362
- </div>
363
- <div class="method">
364
- <div class="title">
365
- <a name="M000035"></a><b>in</b>(seconds)
366
- </div>
367
- <div class="description">
368
- <p>
369
- Alias for <a href="Date.html#M000034">since</a>
370
- </p>
371
- </div>
372
- </div>
373
- <div class="method">
374
- <div class="title">
375
- <a name="M000037"></a><b>midnight</b>()
376
- </div>
377
- <div class="description">
378
- <p>
379
- Alias for <a href="Date.html#M000036">beginning_of_day</a>
380
- </p>
381
- </div>
382
- </div>
383
- <div class="method">
384
- <div class="title">
385
- <a name="M000029"></a><b>month_name</b>()
386
- </div>
387
- <div class="description">
388
- <p>
389
- Get the month name for this date object
390
- </p>
391
- <p>
392
- CREDIT: Benjamin Oakes
393
- </p>
394
- </div>
395
- <div class="sourcecode">
396
- <p class="source-link">[ <a href="javascript:toggleSource('M000029_source')" id="l_M000029_source">+</a> ]</p>
397
- <div id="M000029_source" class="dyn-source">
398
- <pre>
399
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 101</span>
400
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">month_name</span>
401
- <span class="ruby-constant">MONTHNAMES</span>[<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">month</span>]
402
- <span class="ruby-keyword kw">end</span>
403
- </pre>
404
- </div>
405
- </div>
406
- </div>
407
- <div class="method">
408
- <div class="title">
409
- <a name="M000034"></a><b>since</b>(seconds)
410
- </div>
411
- <div class="description">
412
- <p>
413
- Converts <a href="Date.html">Date</a> to a <a href="Time.html">Time</a> (or
414
- <a href="DateTime.html">DateTime</a> if necessary) with the time portion
415
- set to the beginning of the day (0:00) and then adds the specified number
416
- of seconds
417
- </p>
418
- </div>
419
- <div class="aka">
420
- This method is also aliased as
421
- <a href="Date.html#M000035">in</a>
422
- </div>
423
- <div class="sourcecode">
424
- <p class="source-link">[ <a href="javascript:toggleSource('M000034_source')" id="l_M000034_source">+</a> ]</p>
425
- <div id="M000034_source" class="dyn-source">
426
- <pre>
427
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 170</span>
428
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">since</span>(<span class="ruby-identifier">seconds</span>)
429
- <span class="ruby-identifier">to_time</span>.<span class="ruby-identifier">since</span>(<span class="ruby-identifier">seconds</span>)
430
- <span class="ruby-keyword kw">end</span>
431
- </pre>
432
- </div>
433
- </div>
434
- </div>
435
- <div class="method">
436
- <div class="title">
437
- <a name="M000030"></a><b>stamp</b>(format=:default)
438
- </div>
439
- <div class="description">
440
- <p>
441
- Convert to a formatted string. See DATE_FORMATS for predefined formats.
442
- </p>
443
- <p>
444
- This method is aliased to <tt>to_s</tt>.
445
- </p>
446
- <h4>Examples:</h4>
447
- <pre>
448
- date = Date.new(2007, 11, 10) # =&gt; Sat, 10 Nov 2007
449
-
450
- date.stamp(:db) # =&gt; &quot;2007-11-10&quot;
451
- date.stamp(:short) # =&gt; &quot;10 Nov&quot;
452
- date.stamp(:long) # =&gt; &quot;November 10, 2007&quot;
453
- date.stamp(:rfc822) # =&gt; &quot;10 Nov 2007&quot;
454
- </pre>
455
- <h2>Adding your own formats to <a href="Date.html#M000030">stamp</a></h2>
456
- <p>
457
- You can add your own formats to the Date::FORMAT hash. Use the format name
458
- as the hash key and a strftime string as the value. Eg.
459
- </p>
460
- <pre>
461
- Date::FORMAT[:month_and_year] = &quot;%B %Y&quot;
462
- </pre>
463
- </div>
464
- <div class="sourcecode">
465
- <p class="source-link">[ <a href="javascript:toggleSource('M000030_source')" id="l_M000030_source">+</a> ]</p>
466
- <div id="M000030_source" class="dyn-source">
467
- <pre>
468
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 124</span>
469
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stamp</span>(<span class="ruby-identifier">format</span>=<span class="ruby-identifier">:default</span>)
470
- <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">formatter</span> = <span class="ruby-constant">FORMAT</span>[<span class="ruby-identifier">format</span>]
471
- <span class="ruby-identifier">strftime</span>(<span class="ruby-identifier">formatter</span>)
472
- <span class="ruby-keyword kw">else</span>
473
- <span class="ruby-identifier">to_s</span>
474
- <span class="ruby-keyword kw">end</span>
475
- <span class="ruby-keyword kw">end</span>
476
- </pre>
477
- </div>
478
- </div>
479
- </div>
480
- <div class="method">
481
- <div class="title">
482
- <a name="M000023"></a><b>to_date</b>()
483
- </div>
484
- <div class="description">
485
- <p>
486
- A method to keep <a href="Time.html">Time</a>, <a href="Date.html">Date</a>
487
- and <a href="DateTime.html">DateTime</a> instances interchangeable on
488
- conversions. In this case, it simply returns <tt>self</tt>.
489
- </p>
490
- </div>
491
- <div class="sourcecode">
492
- <p class="source-link">[ <a href="javascript:toggleSource('M000023_source')" id="l_M000023_source">+</a> ]</p>
493
- <div id="M000023_source" class="dyn-source">
494
- <pre>
495
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 49</span>
496
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_date</span>
497
- <span class="ruby-keyword kw">self</span>
498
- <span class="ruby-keyword kw">end</span>
499
- </pre>
500
- </div>
501
- </div>
502
- </div>
503
- <div class="method">
504
- <div class="title">
505
- <a name="M000024"></a><b>to_datetime</b>()
506
- </div>
507
- <div class="description">
508
- <p>
509
- Converts a <a href="Date.html">Date</a> instance to a <a
510
- href="DateTime.html">DateTime</a>, where the time is set to the beginning
511
- of the day and UTC offset is set to 0.
512
- </p>
513
- <h4>Example:</h4>
514
- <pre>
515
- date = Date.new(2007, 11, 10) # =&gt; Sat, 10 Nov 2007
516
-
517
- date.to_datetime # =&gt; Sat, 10 Nov 2007 00:00:00 0000
518
- </pre>
519
- </div>
520
- <div class="sourcecode">
521
- <p class="source-link">[ <a href="javascript:toggleSource('M000024_source')" id="l_M000024_source">+</a> ]</p>
522
- <div id="M000024_source" class="dyn-source">
523
- <pre>
524
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 60</span>
525
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_datetime</span>
526
- <span class="ruby-operator">::</span><span class="ruby-constant">DateTime</span>.<span class="ruby-identifier">civil</span>(<span class="ruby-identifier">year</span>, <span class="ruby-identifier">month</span>, <span class="ruby-identifier">day</span>, <span class="ruby-value">0</span>, <span class="ruby-value">0</span>, <span class="ruby-value">0</span>, <span class="ruby-value">0</span>)
527
- <span class="ruby-keyword kw">end</span>
528
- </pre>
529
- </div>
530
- </div>
531
- </div>
532
- <div class="method">
533
- <div class="title">
534
- <a name="M000025"></a><b>to_time</b>(form=:local)
535
- </div>
536
- <div class="description">
537
- <p>
538
- Converts a <a href="Date.html">Date</a> instance to a <a
539
- href="Time.html">Time</a>, where the time is set to the beginning of the
540
- day. The timezone can be either :local or :utc (default :local).
541
- </p>
542
- <pre>
543
- date = Date.new(2007, 11, 10) # =&gt; Sat, 10 Nov 2007
544
-
545
- date.to_time # =&gt; Sat Nov 10 00:00:00 0800 2007
546
- date.to_time(:local) # =&gt; Sat Nov 10 00:00:00 0800 2007
547
-
548
- date.to_time(:utc) # =&gt; Sat Nov 10 00:00:00 UTC 2007
549
- </pre>
550
- </div>
551
- <div class="sourcecode">
552
- <p class="source-link">[ <a href="javascript:toggleSource('M000025_source')" id="l_M000025_source">+</a> ]</p>
553
- <div id="M000025_source" class="dyn-source">
554
- <pre>
555
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 74</span>
556
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_time</span>(<span class="ruby-identifier">form</span>=<span class="ruby-identifier">:local</span>)
557
- <span class="ruby-operator">::</span><span class="ruby-constant">Time</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">form</span>, <span class="ruby-identifier">year</span>, <span class="ruby-identifier">month</span>, <span class="ruby-identifier">day</span>)
558
- <span class="ruby-comment cmt">#::Time.send(&quot;#{form}_time&quot;, year, month, day)</span>
559
- <span class="ruby-keyword kw">end</span>
560
- </pre>
561
- </div>
562
- </div>
563
- </div>
564
- <div class="method">
565
- <div class="title">
566
- <a name="M000039"></a><b>tomorrow</b>()
567
- </div>
568
- <div class="description">
569
- <p>
570
- Convenience method which returns a new <a href="Date.html">Date</a>/<a
571
- href="DateTime.html">DateTime</a> representing the time 1 day <a
572
- href="Date.html#M000034">since</a> the instance time
573
- </p>
574
- </div>
575
- <div class="sourcecode">
576
- <p class="source-link">[ <a href="javascript:toggleSource('M000039_source')" id="l_M000039_source">+</a> ]</p>
577
- <div id="M000039_source" class="dyn-source">
578
- <pre>
579
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 187</span>
580
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tomorrow</span>
581
- <span class="ruby-keyword kw">self</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>
582
- <span class="ruby-keyword kw">end</span>
583
- </pre>
584
- </div>
585
- </div>
586
- </div>
587
- <div class="method">
588
- <div class="title">
589
- <a name="M000026"></a><b>xmlschema</b>()
590
- </div>
591
- <div class="sourcecode">
592
- <p class="source-link">[ <a href="javascript:toggleSource('M000026_source')" id="l_M000026_source">+</a> ]</p>
593
- <div id="M000026_source" class="dyn-source">
594
- <pre>
595
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 79</span>
596
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">xmlschema</span>
597
- <span class="ruby-identifier">to_time</span>.<span class="ruby-identifier">xmlschema</span>
598
- <span class="ruby-keyword kw">end</span>
599
- </pre>
600
- </div>
601
- </div>
602
- </div>
603
- <div class="method">
604
- <div class="title">
605
- <a name="M000038"></a><b>yesterday</b>()
606
- </div>
607
- <div class="description">
608
- <p>
609
- Convenience method which returns a new <a href="Date.html">Date</a>/<a
610
- href="DateTime.html">DateTime</a> representing the time 1 day <a
611
- href="Date.html#M000033">ago</a>
612
- </p>
613
- </div>
614
- <div class="sourcecode">
615
- <p class="source-link">[ <a href="javascript:toggleSource('M000038_source')" id="l_M000038_source">+</a> ]</p>
616
- <div id="M000038_source" class="dyn-source">
617
- <pre>
618
- <span class="ruby-comment cmt"># File lib/lore/facets/date.rb, line 182</span>
619
- <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">yesterday</span>
620
- <span class="ruby-keyword kw">self</span> <span class="ruby-operator">-</span> <span class="ruby-value">1</span>
621
- <span class="ruby-keyword kw">end</span>
622
- </pre>
623
- </div>
624
- </div>
625
- </div>
626
- </div>
627
-
628
- </div>
629
-
630
- </body>
631
- </html>