Initial commit: OCA Technical packages (595 packages)

odoo-bringout-oca-server-tools-datetime_formatter/datetime_formatter/readme/CONTRIBUTORS.rst

@@ -0,0 +1,9 @@
+* `Tecnativa <https://www.tecnativa.com>`_:
+
+  * Jairo Llopis
+  * Vicent Cubells
+  * Ernesto Tejeda
+  * Víctor Martínez
+  * Carolina Fernandez
+* Tautvydas Banevičius <baneviciustautvydas@gmail.com>
+* Dhara Solanki <dhara.solanki@initos.com>

odoo-bringout-oca-server-tools-datetime_formatter/datetime_formatter/readme/DESCRIPTION.rst

@@ -0,0 +1,3 @@
+This module was written to extend the functionality of Odoo language engine to
+support formatting `Date`, `Time` and `Datetime` fields easily and allow you to
+print them in the best format for the user.

odoo-bringout-oca-server-tools-datetime_formatter/datetime_formatter/readme/USAGE.rst

@@ -0,0 +1,21 @@
+This module adds a technical programming feature, and it should be used by
+addon developers, not by end users. This means that you must not expect to see
+any changes if you are a user and install this, but if you find you have it
+already installed, it's probably because you have another modules that depend
+on this one.
+
+If you are a developer, to use this module, you need to:
+
+* Call anywhere in your code::
+
+    formatted_string = self.env["res.lang"].datetime_formatter(datetime_value)
+
+* If you use Qweb::
+
+    <t t-esc="env['res.lang'].datetime_formatter(datetime_value)"/>
+
+* If you call it from a record that has a `lang` field::
+
+    formatted_string = record.lang.datetime_formatter(record.datetime_field)
+
+* ``models.ResLang.datetime_formatter`` docstring explains its usage.