django datetime小部件是django框架中用于datefield、timefiled和datetimefield的简单而干净的小部件。它基于bootstrap datetime picker,支持bootstrap 3和bootstrap 2,支持字体awesome。特别感谢alfredo saglimbeni[https://github.com/asaglimbeni]提供的django datetime小部件
django-datetime-widget-fa的Python项目详细描述
django datetime widget fa
============
``django datetime widget fa``是django框架中用于datefield、timefiled和datetimefield的简单且干净的picker小部件。它基于"bootstrap datetime picker
<;https://github.com/smalot/bootstrap datetimepicker>;`` u3同时支持bootstrap 3和bootstrap 2。
``django datetime widget fa``在使用日期字段时是完美的,模型/窗体中的timefield或datetimefield,其中需要使用特定的日期/时间格式显示相应的选择器。现在它支持django本地化。
available widgets
----
**datetimewidget**:使用日历和时间选择器显示输入。
**datewidget**:仅使用日历选择器显示输入。
**timewidget**:仅使用时间选择器。
`请参阅演示页<;http://bit.ly/django datetime widget demo page>;`
要求
----
*`bootstrap<;http://getbootstrap.com/>;``u2.0.4+和3.2.0
*`jquery<;http://jquery.com/>;` 1.7.1+
屏幕截图图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard戋decade.png
图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard廑year.png
此视图允许用户选择所选年份中的月份。
*月份视图
。图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard戋month.png
图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard戋day.png
此视图允许用户选择所选日期中的小时。
*hour view
。图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard戋hour.png
此视图允许用户选择所选小时中的预设分钟数。
已选择5分钟的范围(默认情况下)以将按钮数量限制为可接受的值,但它可以被<;code>;minutestep<;/code>;属性覆盖。
*日视图-子午线
…图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard_day_meridian.png
Meridian在日视图和时视图中都受支持。
要使用它,只需启用<;code>;showmidian<;/code>;属性即可。
*hour view-meridian
图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard_hour_meridian.png
使用pip安装django datetime小部件fa。例如::
。将"DateTimeWidget"添加到已安装的应用程序中。
如果要使用本地化:
。设置use_l10n=true,使用_tz=true,并在settings.py中使用_i18n=true。将"django.middleware.locale.localemidleware"添加到settings.py中的middleware类中。创建小部件时,添加usel10n=true like属性:datetimewidget(usel10n=true)
基本配置
----
。创建模型窗体并将DateTimeWidget小部件设置为DateTimeField::
from DateTimeWidget.Widgets导入DateTimeWidget
Class YourForm(forms.modelForm):
Class Meta:
Model=YourModel
Widgets={
本地化和引导3
"datetime":datetimewidget(attrs={id':"yourdatetimeid"},usel10n=true,bootstrap_version=3)
}
下载'twitter bootstrap<;http://getbootstrap.com/>;``转到静态文件文件夹。
添加到jquery、bootstrap和form.media的表单模板链接:
<;head>;
……
<;script src="https://ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js">;
<;链接:"{{static\u url}css/bootstrap.css" rel="stylesheet"type="text/css"/>;
<;脚本src="{{static\u url}}js/bootstrap.js">;
{{form.media}
…
<;/head>;
<;body>;
<;表单操作=""method="post">;
{%csrf_token%}
{{form.as_table}
<;input id="submit"type="submit"value="submit">;
<;form>;
<;/body>;
。可选:可以将选项字典添加到DateTimeWidget以自定义输入。例如,将日期和时间与子午线::
datetimeoptions={
'格式':'dd/mm/yyyy hh:ii p',
'自动关闭':true,
"showMeridian":true
}
widgets={
不使用本地化并设置默认格式
"datetime":datetimewidget(options=datetimeoptions)
}
!!!!如果在选项中添加"format",同时将usel10n设置为true,则会忽略第一个选项。!!!!
选项
==
选项属性可以接受以下内容:
*格式
字符串。默认值:"dd/mm/yy yy hh:ii"
p、hh、hh、ii、ss、dd、yy、yyyy的组合日期格式。
*p:meridian大写('am'或'pm')-根据区域设置文件
*ss:seconds,2位数字,前导零
*ii:minutes,2位数字带前导零
*hh:hour,2位数字带前导零-24小时格式
*hh:hour,2位数字带前导零-12小时格式
*dd:day of the month,带前导零的2位数
*yy:一年的两位数表示
*yyyy:一年的完整数字表示,4位数
*weekstart
默认值:0
0'(星期日)到6'(星期六)
*开始日期
默认值:开始时间
可以选择的最早日期;所有较早的日期都将被禁用。
*结束日期
默认值:结束时间
可以选择的最新日期;所有以后的日期都将被禁用。
*daysofweekdisabled
string。默认值:'
一周中应禁用的天数。值为0(星期日)到6(星期六)。多个值应以逗号分隔。示例:禁用周末:"0,6"。
*autoclose
string。默认值:"true"
选择日期时是否立即关闭DateTimePicker。
*startView
默认值:2
DateTimePicker打开时应显示的视图。
接受值:
*'0'表示小时视图
*'1'表示日视图
*'2'表示月视图(默认值)
*'3'表示12个月视图
*'4'表示10年概览。对于出生日期计时器选择器很有用。
*minview
integer。默认值:0
DateTimePicker应显示的最低视图。
*maxview
integer。默认值:4
DateTimePicker应显示的最高视图。
*todaybtn
boolean。默认值:false
如果为true,则在DateTimePicker底部显示"今日"按钮以选择当前日期。如果为真,"今日"按钮将只将当前日期移动到视图中。
*今日突出显示
>布尔值。默认值:false
如果为true,则突出显示当前日期。
*minutestep
integer。默认值:5
用于生成小时视图的增量。为每分钟创建一个按钮。
*pickerposition
默认值:ottom right'(其他受支持的值:"bottom left")
默认值:false
此选项将启用日视图和时视图的子午线视图。
*clearbtn
boolean。默认值:false
如果为true,则在输入值的右侧显示一个"清除"按钮。
--
*0.9.3v
*fix 48
*python 3支持
*0.9.2v
*fix 46
*0.9.1v
*python选项转换正确到javascript选项。
*fix 38 40.
*代码重构和错误修复。
*0.9v
*将引导日期时间选取器更新到最新版本。
*close 20(支持引导2和引导3)。
*close 17 timewidget.
*close 16DateWidget.
*在输入值右侧添加新的清除按钮。
*添加DateTimeExample Django项目。
*0.6V
*添加清除按钮
*修复类型错误错误
*支持本地化
*用最后一个更新静态文件提交bootstrap datetime picker
*update js lib,本机本地化,感谢@quantum13
*autoclose默认为true
contribut
--
1。检查打开的问题或打开一个新的问题,开始围绕功能想法或错误的讨论。对于那些还不太熟悉代码库的人来说,有一个"贡献者友好"标签应该是非常理想的。
*如果你对某个问题或你的更改感到不舒服或不确定,可以随时给@haikson发邮件,他会很乐意通过电子邮件、skype、远程帮助你。配对或任何你觉得舒服的东西。
2.从github上的repository分支develop,开始对**develop**分支(或其分支)进行更改。
3.请显示错误已修复或功能正常工作。
4.发送一个pull请求并对维护程序进行bug操作,直到它被合并并发布。(
5)。您的更改将在下一个版本的django_datetime_小部件上发布!
…_`存储库`:https://github.com/haikson/django datetime widget fa
。_贡献者友好:https://github.com/haikson/django-datetime-widget-fa/issues?方向=DESC&LABELS=contributor+友好页面=1&sort=updated&state=open
todo
----
。日期时间范围的小部件。
============
``django datetime widget fa``是django框架中用于datefield、timefiled和datetimefield的简单且干净的picker小部件。它基于"bootstrap datetime picker
<;https://github.com/smalot/bootstrap datetimepicker>;`` u3同时支持bootstrap 3和bootstrap 2。
``django datetime widget fa``在使用日期字段时是完美的,模型/窗体中的timefield或datetimefield,其中需要使用特定的日期/时间格式显示相应的选择器。现在它支持django本地化。
available widgets
----
**datetimewidget**:使用日历和时间选择器显示输入。
**datewidget**:仅使用日历选择器显示输入。
**timewidget**:仅使用时间选择器。
`请参阅演示页<;http://bit.ly/django datetime widget demo page>;`
要求
----
*`bootstrap<;http://getbootstrap.com/>;``u2.0.4+和3.2.0
*`jquery<;http://jquery.com/>;` 1.7.1+
屏幕截图图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard戋decade.png
图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard廑year.png
此视图允许用户选择所选年份中的月份。
*月份视图
。图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard戋month.png
图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard戋day.png
此视图允许用户选择所选日期中的小时。
*hour view
。图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard戋hour.png
此视图允许用户选择所选小时中的预设分钟数。
已选择5分钟的范围(默认情况下)以将按钮数量限制为可接受的值,但它可以被<;code>;minutestep<;/code>;属性覆盖。
*日视图-子午线
…图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard_day_meridian.png
Meridian在日视图和时视图中都受支持。
要使用它,只需启用<;code>;showmidian<;/code>;属性即可。
*hour view-meridian
图片::https://raw.github.com/smalot/bootstrap datetimepicker/master/screenshot/standard_hour_meridian.png
使用pip安装django datetime小部件fa。例如::
。将"DateTimeWidget"添加到已安装的应用程序中。
如果要使用本地化:
。设置use_l10n=true,使用_tz=true,并在settings.py中使用_i18n=true。将"django.middleware.locale.localemidleware"添加到settings.py中的middleware类中。创建小部件时,添加usel10n=true like属性:datetimewidget(usel10n=true)
基本配置
----
。创建模型窗体并将DateTimeWidget小部件设置为DateTimeField::
from DateTimeWidget.Widgets导入DateTimeWidget
Class YourForm(forms.modelForm):
Class Meta:
Model=YourModel
Widgets={
本地化和引导3
"datetime":datetimewidget(attrs={id':"yourdatetimeid"},usel10n=true,bootstrap_version=3)
}
下载'twitter bootstrap<;http://getbootstrap.com/>;``转到静态文件文件夹。
添加到jquery、bootstrap和form.media的表单模板链接:
<;head>;
……
<;script src="https://ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js">;
<;链接:"{{static\u url}css/bootstrap.css" rel="stylesheet"type="text/css"/>;
<;脚本src="{{static\u url}}js/bootstrap.js">;
{{form.media}
…
<;/head>;
<;body>;
<;表单操作=""method="post">;
{%csrf_token%}
{{form.as_table}
<;input id="submit"type="submit"value="submit">;
<;form>;
<;/body>;
。可选:可以将选项字典添加到DateTimeWidget以自定义输入。例如,将日期和时间与子午线::
datetimeoptions={
'格式':'dd/mm/yyyy hh:ii p',
'自动关闭':true,
"showMeridian":true
}
widgets={
不使用本地化并设置默认格式
"datetime":datetimewidget(options=datetimeoptions)
}
!!!!如果在选项中添加"format",同时将usel10n设置为true,则会忽略第一个选项。!!!!
选项
==
选项属性可以接受以下内容:
*格式
字符串。默认值:"dd/mm/yy yy hh:ii"
p、hh、hh、ii、ss、dd、yy、yyyy的组合日期格式。
*p:meridian大写('am'或'pm')-根据区域设置文件
*ss:seconds,2位数字,前导零
*ii:minutes,2位数字带前导零
*hh:hour,2位数字带前导零-24小时格式
*hh:hour,2位数字带前导零-12小时格式
*dd:day of the month,带前导零的2位数
*yy:一年的两位数表示
*yyyy:一年的完整数字表示,4位数
*weekstart
默认值:0
0'(星期日)到6'(星期六)
*开始日期
默认值:开始时间
可以选择的最早日期;所有较早的日期都将被禁用。
*结束日期
默认值:结束时间
可以选择的最新日期;所有以后的日期都将被禁用。
*daysofweekdisabled
string。默认值:'
一周中应禁用的天数。值为0(星期日)到6(星期六)。多个值应以逗号分隔。示例:禁用周末:"0,6"。
*autoclose
string。默认值:"true"
选择日期时是否立即关闭DateTimePicker。
*startView
默认值:2
DateTimePicker打开时应显示的视图。
接受值:
*'0'表示小时视图
*'1'表示日视图
*'2'表示月视图(默认值)
*'3'表示12个月视图
*'4'表示10年概览。对于出生日期计时器选择器很有用。
*minview
integer。默认值:0
DateTimePicker应显示的最低视图。
*maxview
integer。默认值:4
DateTimePicker应显示的最高视图。
*todaybtn
boolean。默认值:false
如果为true,则在DateTimePicker底部显示"今日"按钮以选择当前日期。如果为真,"今日"按钮将只将当前日期移动到视图中。
*今日突出显示
>布尔值。默认值:false
如果为true,则突出显示当前日期。
*minutestep
integer。默认值:5
用于生成小时视图的增量。为每分钟创建一个按钮。
*pickerposition
默认值:ottom right'(其他受支持的值:"bottom left")
默认值:false
此选项将启用日视图和时视图的子午线视图。
*clearbtn
boolean。默认值:false
如果为true,则在输入值的右侧显示一个"清除"按钮。
*0.9.3v
*fix 48
*python 3支持
*0.9.2v
*fix 46
*0.9.1v
*python选项转换正确到javascript选项。
*fix 38 40.
*代码重构和错误修复。
*0.9v
*将引导日期时间选取器更新到最新版本。
*close 20(支持引导2和引导3)。
*close 17 timewidget.
*close 16DateWidget.
*在输入值右侧添加新的清除按钮。
*添加DateTimeExample Django项目。
*0.6V
*添加清除按钮
*修复类型错误错误
*支持本地化
*用最后一个更新静态文件提交bootstrap datetime picker
*update js lib,本机本地化,感谢@quantum13
*autoclose默认为true
contribut
--
1。检查打开的问题或打开一个新的问题,开始围绕功能想法或错误的讨论。对于那些还不太熟悉代码库的人来说,有一个"贡献者友好"标签应该是非常理想的。
*如果你对某个问题或你的更改感到不舒服或不确定,可以随时给@haikson发邮件,他会很乐意通过电子邮件、skype、远程帮助你。配对或任何你觉得舒服的东西。
2.从github上的repository分支develop,开始对**develop**分支(或其分支)进行更改。
3.请显示错误已修复或功能正常工作。
4.发送一个pull请求并对维护程序进行bug操作,直到它被合并并发布。(
5)。您的更改将在下一个版本的django_datetime_小部件上发布!
…_`存储库`:https://github.com/haikson/django datetime widget fa
。_贡献者友好:https://github.com/haikson/django-datetime-widget-fa/issues?方向=DESC&LABELS=contributor+友好页面=1&sort=updated&state=open
todo
----
。日期时间范围的小部件。