Ticket #9853: field_normalization.diff

File field_normalization.diff, 1.5 KB (added by Jeff Anderson, 15 years ago)

added notes about normalizing to Python objects

  • docs/ref/models/fields.txt 

    diff --git a/docs/ref/models/fields.txt b/docs/ref/models/fields.txt
index 340dcff..e0418d6 100644
    a b portability mentioned there should be heeded.  
    365365
    366366.. class:: DateField([auto_now=False, auto_now_add=False, **options])
    367367
    368 A date field. Has a few extra optional arguments:
     368A date field. Normalizes to a Python ``datetime.date`` object. Has a few extra
     369optional arguments:
    369370
    370371.. attribute:: DateField.auto_now
    371372
    … … the week on a Sunday.  
    388389
    389390.. class:: DateTimeField([auto_now=False, auto_now_add=False, **options])
    390391
    391 A date and time field. Takes the same extra options as :class:`DateField`.
     392A date and time field. Normalizes to a Python ``datetime.datetime`` object.
     393Takes the same extra options as :class:`DateField`.
    392394
    393395The admin represents this as two ``<input type="text">`` fields, with JavaScript
    394396shortcuts.
    … … input).  
    706708
    707709.. class:: TimeField([auto_now=False, auto_now_add=False, **options])
    708710
    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.
     711A time field. Normalizes to a Python ``datetime.time`` object. Accepts the same
     712auto-population options as :class:`DateField` and :class:`DateTimeField`. The
     713admin represents this as an ``<input type="text">`` with some JavaScript
     714shortcuts.
    712715
    713716``URLField``
    714717------------
Back to Top