summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/contrib/postgres/fields.txt6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/ref/contrib/postgres/fields.txt b/docs/ref/contrib/postgres/fields.txt
index f5c98929b7..cb6f15acc5 100644
--- a/docs/ref/contrib/postgres/fields.txt
+++ b/docs/ref/contrib/postgres/fields.txt
@@ -467,6 +467,12 @@ JSONField
its Python native format: dictionaries, lists, strings, numbers, booleans
and ``None``.
+ If you want to store other data types, you'll need to serialize them first.
+ For example, you might cast a ``datetime`` to a string. You might also want
+ to convert the string back to a ``datetime`` when you retrieve the data
+ from the database. There are some third-party ``JSONField`` implementations
+ which do this sort of thing automatically.
+
If you give the field a :attr:`~django.db.models.Field.default`, ensure
it's a callable such as ``dict`` (for an empty default) or a callable that
returns a dict (such as a function). Incorrectly using ``default={}``