Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Fixed #9853 -- Added information to the model date/time fields to not…

…e the Python objects used to represent them.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10198 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit 8ed6b2b1d137cc7c9f2a4eed0711ca61a49b1a2e 1 parent 867e715
Gary Wilson Jr. authored March 30, 2009

Showing 1 changed file with 15 additions and 11 deletions. Show diff stats Hide diff stats

  1. 26  docs/ref/models/fields.txt
26  docs/ref/models/fields.txt
@@ -365,13 +365,14 @@ portability mentioned there should be heeded.
365 365
 
366 366
 .. class:: DateField([auto_now=False, auto_now_add=False, **options])
367 367
 
368  
-A date field. Has a few extra optional arguments:
  368
+A date, represented in Python by a ``datetime.date`` instance. Has a few extra,
  369
+optional arguments:
369 370
 
370 371
 .. attribute:: DateField.auto_now
371 372
 
372 373
     Automatically set the field to now every time the object is saved. Useful
373  
-    for "last-modified" timestamps. Note that the current date is *always* used;
374  
-    it's not just a default value that you can override.
  374
+    for "last-modified" timestamps. Note that the current date is *always*
  375
+    used; it's not just a default value that you can override.
375 376
 
376 377
 .. attribute:: DateField.auto_now_add
377 378
 
@@ -380,18 +381,19 @@ A date field. Has a few extra optional arguments:
380 381
     it's not just a default value that you can override.
381 382
 
382 383
 The admin represents this as an ``<input type="text">`` with a JavaScript
383  
-calendar, and a shortcut for "Today".  The JavaScript calendar will always start
384  
-the week on a Sunday.
  384
+calendar, and a shortcut for "Today".  The JavaScript calendar will always
  385
+start the week on a Sunday.
385 386
 
386 387
 ``DateTimeField``
387 388
 -----------------
388 389
 
389 390
 .. class:: DateTimeField([auto_now=False, auto_now_add=False, **options])
390 391
 
391  
-A date and time field. Takes the same extra options as :class:`DateField`.
  392
+A date and time, represented in Python by a ``datetime.datetime`` instance.
  393
+Takes the same extra arguments as :class:`DateField`.
392 394
 
393  
-The admin represents this as two ``<input type="text">`` fields, with JavaScript
394  
-shortcuts.
  395
+The admin represents this as two ``<input type="text">`` fields, with
  396
+JavaScript shortcuts.
395 397
 
396 398
 ``DecimalField``
397 399
 ----------------
@@ -706,9 +708,11 @@ input).
706 708
 
707 709
 .. class:: TimeField([auto_now=False, auto_now_add=False, **options])
708 710
 
709  
-A time. Accepts the same auto-population options as :class:`DateField` and
710  
-:class:`DateTimeField`. The admin represents this as an ``<input type="text">``
711  
-with some JavaScript shortcuts.
  711
+A time, represented in Python by a ``datetime.time`` instance. Accepts the same
  712
+auto-population options as :class:`DateField`.
  713
+
  714
+The admin represents this as an ``<input type="text">`` with some JavaScript
  715
+shortcuts.
712 716
 
713 717
 ``URLField``
714 718
 ------------

0 notes on commit 8ed6b2b

Please sign in to comment.
Something went wrong with that request. Please try again.