Fix #1362 - Running Unit tests against SQLite fails on datetime/UTC (#1378)

Author: fredericDelaporte

doc/reference/modules/configuration.xml

@@ -1289,6 +1289,13 @@ in the parameter binding.</programlisting>
                                 Set <literal>driver_class</literal> to
                                 <literal>NHibernate.Driver.SQLite20Driver</literal>
                                 for System.Data.SQLite provider for .NET 2.0.
+                                <para>
+                                    Due to
+                                    <ulink url="https://system.data.sqlite.org/index.html/tktview/44a0955ea344a777ffdbcc077831e1adc8b77a36">the
+                                    behavior of System.Data.SQLite</ulink> with <literal>DateTime</literal>, consider using
+                                    <literal>DateTimeFormatString=yyyy-MM-dd HH:mm:ss.FFFFFFF;</literal> in the SQLite
+                                    connection string for preventing undesired time shifts with its default configuration.
+                                </para>
                             </entry>
                         </row>
                         <row>

src/NHibernate.Config.Templates/SQLite.cfg.xml

@@ -7,9 +7,14 @@ for your own use before compile tests in VisualStudio.
 <hibernate-configuration  xmlns="urn:nhibernate-configuration-2.2" >
 	<session-factory name="NHibernate.Test">
 		<property name="connection.driver_class">NHibernate.Driver.SQLite20Driver</property>
+		<!-- DateTimeFormatString allows to prevent storing the fact that written date was having kind UTC,
+		     which dodges the undesirable time conversion to local done on reads by System.Data.SQLite.
+		     See https://system.data.sqlite.org/index.html/tktview/44a0955ea344a777ffdbcc077831e1adc8b77a36
+		     and https://github.com/nhibernate/nhibernate-core/issues/1362 -->
 		<property name="connection.connection_string">
-			Data Source=nhibernate.db
+			Data Source=nhibernate.db;
+			DateTimeFormatString=yyyy-MM-dd HH:mm:ss.FFFFFFF;
 		</property>
 		<property name="dialect">NHibernate.Dialect.SQLiteDialect</property>
 	</session-factory>
-</hibernate-configuration>
+</hibernate-configuration>

teamcity.build

@@ -108,8 +108,12 @@
 
 	<target name="setup-teamcity-sqlite32">
 		<property name="nhibernate.connection.driver_class"			value="NHibernate.Driver.SQLite20Driver" />
+		<!-- DateTimeFormatString allows to prevent storing the fact that written date was having kind UTC,
+		     which dodges the undesirable time conversion to local done on reads by System.Data.SQLite.
+		     See https://system.data.sqlite.org/index.html/tktview/44a0955ea344a777ffdbcc077831e1adc8b77a36
+		     and https://github.com/nhibernate/nhibernate-core/issues/1362 -->
 		<property name="nhibernate.dialect"							value="NHibernate.Dialect.SQLiteDialect" />
-		<property name="nhibernate.connection.connection_string"	value="Data Source=NHibernate.db" />
+		<property name="nhibernate.connection.connection_string"	value="Data Source=NHibernate.db;DateTimeFormatString=yyyy-MM-dd HH:mm:ss.FFFFFFF;" />
 		<copy todir="${bin.dir}">
 			<fileset basedir="${root.dir}/lib/teamcity/sqlite/x86">
 				<include name="*.dll"/>
@@ -120,8 +124,12 @@
 	<target name="setup-teamcity-sqlite64">
 		<property name="nunit-x64" value="true" />
 		<property name="nhibernate.connection.driver_class"			value="NHibernate.Driver.SQLite20Driver" />
+		<!-- DateTimeFormatString allows to prevent storing the fact that written date was having kind UTC,
+		     which dodges the undesirable time conversion to local done on reads by System.Data.SQLite.
+		     See https://system.data.sqlite.org/index.html/tktview/44a0955ea344a777ffdbcc077831e1adc8b77a36
+		     and https://github.com/nhibernate/nhibernate-core/issues/1362 -->
 		<property name="nhibernate.dialect"							value="NHibernate.Dialect.SQLiteDialect" />
-		<property name="nhibernate.connection.connection_string"	value="Data Source=NHibernate.db" />
+		<property name="nhibernate.connection.connection_string"	value="Data Source=NHibernate.db;DateTimeFormatString=yyyy-MM-dd HH:mm:ss.FFFFFFF;" />
 		<copy todir="${bin.dir}">
 			<fileset basedir="${root.dir}/lib/teamcity/sqlite/x64">
 				<include name="*.dll"/>